Каждая функция выдает результат, который называется возвращаемым значением. Это может быть число, текст, логическое значение (True/False) или дата. Многие функции принимают входные данные, называемые параметрами. Параметры указываются в скобках после названия функции и перечисляются через запятую. Их порядок и форматы данных являются значимыми. Если добавить функцию через меню, то будут автоматически вставлены плейсхолдеры, соответствующие ее параметрам. Каждый плейсхолдер нужно заменить значением параметра, которое должна обработать функция. Функции, в списке параметров которых есть знак "...", могут принимать неограниченное число дополнительных параметров.
Инструкции по работе с функциями в специальных столбцах приведены в статье Как создавать специальные столбцы.
| Категория | Тип возвращаемого значения | Функция | Описание |
| Арифметические операции | Число | round(x) |
Округляет [x] до ближайшего целого числа. |
| Арифметические операции | Число | floor(x) |
Возвращает наибольшее целое число, которое меньше или равно [x]. |
| Арифметические операции | Число | ceiling(x) |
Возвращает наименьшее целое число, которое больше или равно [x]. |
| Логические операции | Зависит от обстоятельств | if(condition, if_true, if_false) |
Проверяет условие [condition] и возвращает [if_true], если условие выполняется, и [if_false] – если не выполняется. Тип возвращаемого значения будет тем же, что и у параметров [if_true] и [if_false]. |
| Логические операции | True/False | or(x, y, ...) |
Возвращает True, если хотя бы одно из условий выполняется. |
| Логические операции | True/False | not(x) |
Возвращает True, если условие [x] не выполняется, и False – если выполняется. |
| Логические операции | True/False | and(x, y, ...) |
Возвращает True, если выполняются все условия. |
| Текстовые операции | Текст | concat(text1, text2, ...) |
Соединяет несколько текстовых строк. |
| Текст | True/False | is_empty(text) |
Возвращает True, если [text] не содержит символов. |
| Текстовые операции | Текст | trim(text) |
Удаляет пробелы в начале и в конце текстовой строки. |
| Текстовые операции | True/False | starts_with(needle, haystack) |
Возвращает True, если начало текстовой строки [haystack] совпадает со строкой [needle]. |
| Текстовые операции | True/False | ends_with(needle, haystack) |
Возвращает True, если конец текстовой строки [haystack] совпадает со строкой [needle]. |
| Текстовые операции | Число | search(needle, haystack) |
Возвращает начальную позицию первого вхождения строки [needle] в строке [haystack]. |
| Текстовые операции | True/False | contains(needle, haystack) |
Возвращает True, если строка [haystack] содержит строку [needle]. |
| Текстовые операции | Текст | right(text, length) |
Возвращает последние символы строки [text], количество которых задается параметром [length]. |
| Текстовые операции | Текст | left(text, length) |
Возвращает первые символы строки [text], количество которых задается параметром [length]. |
| Текстовые операции | Текст | substitute(haystack, needle, replacement) |
Заменяет все вхождения строки [needle] в строке [haystack] на строку [replacement]. |
| Текстовые операции | Текст | upper(text) |
Преобразует все символы строки [text] в символы ВЕРХНЕГО РЕГИСТРА. |
| Текстовые операции | Текст | lower(text) |
Преобразует все символы строки [text] в символы нижнего регистра. |
| Текстовые операции | Число | length(text) |
Возвращает количество символов в строке [text]. |
| Преобразования | Текст | to_text(value) |
Преобразует значение [value] в текст. |
| Преобразования | Число | to_number(value) |
Преобразует значение [value] в число. |
| Операции с датами | Дата | date(year, month, day) |
Возвращает дату, соответствующую указанным году, месяцу и дню. |
| Операции с датами | Число | day(date) |
Возвращает день месяца из даты, заданной параметром [date]. |
| Операции с датами | Число | month(date) |
Возвращает месяц (от 1 до 12) из даты, заданной параметром [date]. |
| Операции с датами | Число | quarter(date) |
Возвращает квартал года (от 1 до 4) из даты, заданной параметром [date]. |
| Операции с датами | Число | year(date) |
Возвращает год (в виде числового значения) из даты, заданной параметром [date]. |
| Операции с датами | Число | weekday(date) |
Возвращает номер дня недели (от 1 до 7) из даты, заданной параметром [date]. Отсчет дней недели начинается с воскресенья – этому дню соответствует число 1. |
| Операции с датами | Число | weeknum(date) |
Возвращает номер недели в году (от 1 до 54) из даты, заданной параметром [date]. Отсчет дней недели начинается с воскресенья. |
| Операции с датами | Число | daynum(date) |
Возвращает номер дня в году (от 1 до 355 или 356) из даты, заданной параметром [date]. |
| Операции с датами | Число | days_between(date1, date2) |
Возвращает количество дней между датами, заданными параметрами [date1] и [date2]. |
| Операции с датами | Дата | offset_days(date, days) |
Добавляет количество дней, заданное параметром [days], к дате, заданной параметром [date]. Количество дней может быть как положительным, так и отрицательным. |
| Операции с датами | Дата | offset_months(date, months) |
Добавляет количество месяцев, заданное параметром [months], к месяцу даты, заданной параметром [date]. Если в результате получается дата, где день месяца превышает максимальное количество дней в этом месяце (например, 31 марта), то возвращается последний день этого месяца (например, 30 марта). |
| Операции с датами | Дата | offset_years(date, years) |
Добавляет количество лет, заданное параметром [years], к году даты, заданной параметром [date]. |
| Операции с датами | Дата | today() |
Возвращает текущую дату в часовом поясе аккаунта, который является владельцем специального столбца. |
| Операции с датами | Дата | yesterday() |
Возвращает вчерашнюю дату в часовом поясе аккаунта, который является владельцем специального столбца. |
| Операции с датами | Дата | week_start_sunday() |
Возвращает дату последнего воскресенья до текущей даты (включительно) в часовом поясе аккаунта, который является владельцем специального столбца. |
| Операции с датами | Дата | week_start_monday() |
Возвращает дату последнего понедельника до текущей даты (включительно) в часовом поясе аккаунта, который является владельцем специального столбца. |
| Операции с датами | Дата | month_start() |
Возвращает дату первого дня текущего месяца в часовом поясе аккаунта, который является владельцем специального столбца. |
| Операции с датами | Дата | year_start() |
Возвращает дату первого дня текущего года (1 января) в часовом поясе аккаунта, который является владельцем специального столбца. |
| Операции с датами | Дата | report_range_start() |
Возвращает начальную дату текущего временного диапазона в отчете. |
| Операции с датами | Дата | report_range_end() |
Возвращает конечную дату текущего временного диапазона в отчете. |
| Операции с датами | Число | report_days_count() |
Возвращает количество дней от начальной до конечной даты отчета. |
