Функції видають результати, які називаються значенням, що повертається. Це може бути число, текст, значення "Правда/неправда" або тип даних (залежно від функції). Для більшості функцій потрібно вводити параметри. Параметри – це дані, які вводяться у функцію після її назви, відокремлюються комами та вказуються в дужках. Важливо враховувати послідовність параметрів і формат даних кожного з них. Якщо ввести функцію з меню, буде вставлено текст заповнювача для кожного параметра. Щоб додати функцію, слід замінити текст заповнювача для кожного параметра. Функції з трьома крапками "..." можуть приймати будь-яку кількість додаткових параметрів.
Вказівки з використання функцій у спеціальних стовпцях наведено в статті Як створювати спеціальні стовпці.
Категорія | Тип повернутого значення | Функція | Опис |
Арифметика | Число | round(x) |
Округлює [x] до найближчого цілого числа |
Арифметика | Число | floor(x) |
Повертає найбільше ціле число, яке менше ніж [x] або дорівнює йому |
Арифметика | Число | ceiling(x) |
Повертає найменше ціле число, яке більше ніж [x] або дорівнює йому |
Логічні дії | Міняється | if(condition, if_true, if_false) |
Оцінює умову "[condition]" і повертає відповідь "[if_true]", якщо умову виконано, і відповідь "[if_false]", якщо умову не виконано. Тип значення, що повертається, відповідатиме типу [if_true] або [if_false]. |
Логічні дії | Правда/неправда | or(x, y, ...) |
Повертає відповідь "Правда", якщо один із параметрів правдивий |
Логічні дії | Правда/неправда | not(x) |
Повертає відповідь "Правда", якщо параметр "[x]" неправдивий, і відповідь "Неправда", якщо параметр "[x]" правдивий |
Логічні дії | Правда/неправда | and(x, y, ...) |
Повертає відповідь "Правда", якщо всі параметри правдиві |
Текст | Текст | concat(text1, text2, ...) |
Поєднує кілька рядків тексту |
Текст | Правда/неправда | is_empty(text) |
Повертає відповідь "Правда", якщо в тексті "[text]" немає символів |
Текст | Текст | trim(text) |
Вилучає пробіли навколо рядка тексту |
Текст | Правда/неправда | starts_with(needle, haystack) |
Повертає відповідь "Правда", якщо рядок тексту "[haystack]" починається з "[needle]" |
Текст | Правда/неправда | ends_with(needle, haystack) |
Повертає значення "Правда", якщо текст "[haystack]" закінчується на "[needle]" |
Текст | Число | search(needle, haystack) |
Повертає початкову позицію першого входження "[needle]" у тексті "[haystack]" |
Текст | Правда/неправда | contains(needle, haystack) |
Повертає відповідь "Правда", якщо рядок тексту "[haystack]" містить "[needle]" |
Текст | Текст | right(text, length) |
Повертає останні символи ([length]) з тексту "[text]" |
Текст | Текст | left(text, length) |
Повертає перші символи ([length]) тексту "[text]" |
Текст | Текст | 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]; якщо отриманий місяць має недостатньо днів для компонента дня, повертається останній день нового місяця |
Дата | Дата | 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() |
Повертає кількість днів, охоплених звітом, на основі дати початку та дати завершення |