> ## Documentation Index > Fetch the complete documentation index at: https://help.teable.ai/llms.txt > Use this file to discover all available pages before exploring further. # Шпаргалка з функцій > Швидко знаходьте функції формул, параметри, типи результатів і базові приклади. Шпаргалка з функцій допомагає знаходити доступні функції, параметри, типи результатів і приклади. Під час написання формули скористайтеся категорією функцій, щоб знайти потрібну функцію. ## Числові функції Числові функції виконують математичні операції, статистичні обчислення та форматування чисел. | Назва функції | Опис | Вхідні дані | Результат | Приклад | | ------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------- | --------- | --------------------------------------------------- | | SUM | Додає числа. Еквівалентно number1 + number2 + ... | `number1, [number2, ...]` | Число | `SUM(100, 200, 300) => 600` | | AVERAGE | Повертає середнє значення чисел. | `number1, [number2, ...]` | Число | `AVERAGE(100, 200, 300) => 200` | | MAX | Повертає найбільше з указаних чисел. | `number1, [number2, ...]` | Число | `MAX(100, 200, 300) => 300` | | MIN | Повертає найменше з указаних чисел. | `number1, [number2, ...]` | Число | `MIN(100, 200, 300) => 100` | | ROUND | Округлює значення до кількості десяткових знаків, указаної параметром «precision». | `value, [precision]` | Число | `ROUND(1.99, 0) => 2` `ROUND(16.8, -1) => 20` | | ROUNDUP | Завжди округлює вгору, від нуля. | `value, [precision]` | Число | `ROUNDUP(1.1, 0) => 2` `ROUNDUP(-1.1, 0) => -2` | | ROUNDDOWN | Завжди округлює вниз, до нуля. | `value, [precision]` | Число | `ROUNDDOWN(1.9, 0) => 1` `ROUNDDOWN(-1.9, 0) => -1` | | CEILING | Повертає найближче ціле кратне, більше або рівне значенню. | `value, [significance]` | Число | `CEILING(2.49) => 3` `CEILING(2.49, 1) => 2.5` | | FLOOR | Повертає найближче ціле кратне, менше або рівне значенню. | `value, [significance]` | Число | `FLOOR(2.49) => 2` `FLOOR(2.49, 1) => 2.4` | | EVEN | Повертає найменше парне число, більше або рівне вказаному значенню. | `value` | Число | `EVEN(0.1) => 2` `EVEN(-0.1) => -2` | | ODD | Округлює додатні значення вгору до найближчого непарного числа, а від’ємні — вниз до найближчого непарного числа. | `value` | Число | `ODD(0.1) => 1` `ODD(-0.1) => -1` | | INT | Повертає цілу частину числа. | `value` | Число | `INT(1.9) => 1` `INT(-1.9) => -2` | | ABS | Повертає абсолютне значення. | `value` | Число | `ABS(-1) => 1` | | SQRT | Повертає квадратний корінь із невід’ємного числа. | `value` | Число | `SQRT(4) => 2` | | POWER | Підносить указану основу до вказаного степеня. | `base, exponent` | Число | `POWER(2, 2) => 4` | | EXP | Підносить число Ейлера (e) до вказаного степеня. | `value` | Число | `EXP(0) => 1` `EXP(1) => 2.718` | | LOG | Обчислює логарифм значення за вказаною основою. Якщо основу не задано, за замовчуванням використовується 10. | `value, [base=10]` | Число | `LOG(100) => 2` `LOG(1024, 2) => 10` | | MOD | Повертає остачу від ділення першого параметра на другий. | `value, divisor` | Число | `MOD(9, 2) => 1` `MOD(9, 3) => 0` | | VALUE | Перетворює текстовий рядок на число. | `text` | Число | `VALUE("$1,000,000") => 1000000` | ## Текстові функції Текстові функції об’єднують, шукають, замінюють, видобувають і розділяють рядки. | Назва функції | Опис | Вхідні дані | Результат | Приклад | | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------- | -------------------------- | ---------------------------------------------------------------- | | CONCATENATE | Об’єднує кілька параметрів різних типів в одне текстове значення. | `text1, [text2, ...]` | Текст | `CONCATENATE("Hello ", "Teable") => Hello Teable` | | FIND | Знаходить позицію підрядка у вказаному тексті. Повертає 0, якщо підрядок не знайдено. | `stringToFind, whereToSearch, [startFromPosition]` | Число | `FIND("Teable", "Hello Teable") => 7` | | SEARCH | Знаходить позицію підрядка у вказаному тексті. Повертає порожнє значення, якщо підрядок не знайдено. Подібна до FIND, але повертає порожнє значення замість 0. | `stringToFind, whereToSearch, [startFromPosition]` | Текст або порожнє значення | `SEARCH("Teable", "Hello Teable") => 7` | | MID | Видобуває вказану кількість символів із текстового рядка, починаючи із заданої позиції. | `text, whereToStart, count` | Текст | `MID("Hello Teable", 6, 6) => "Teable"` | | LEFT | Видобуває вказану кількість символів із початку рядка. | `text, count` | Текст | `LEFT("2023-09-06", 4) => "2023"` | | RIGHT | Видобуває вказану кількість символів із кінця рядка. | `text, count` | Текст | `RIGHT("2023-09-06", 5) => "09-06"` | | REPLACE | Замінює вказану кількість символів, починаючи із заданої позиції, текстом заміни. | `text, whereToStart, count, replacement` | Текст | `REPLACE("Hello Table", 7, 5, "Teable") => "Hello Teable"` | | REGEXP\_REPLACE | Замінює текстом заміни всі підрядки, що відповідають регулярному виразу. | `text, regular_expression, replacement` | Текст | `REGEXP_REPLACE("Hello Table", "H.* ", "") => "Teable"` | | SUBSTITUTE | Замінює старий текст новим. Можна вказати індекс, щоб замінити конкретне входження старого тексту. Якщо індекс не вказано, замінює всі входження. | `text, oldText, newText, [index]` | Текст | `SUBSTITUTE("Hello Table", "Table", "Teable") => "Hello Teable"` | | TEXTBEFORE | Повертає текст перед указаним роздільником. | `text, delimiter` | Текст | `TEXTBEFORE("20, 04, 79", ",") => "20"` | | TEXTSPLIT | Розділяє текст за вказаним роздільником і повертає кілька текстових значень. | `text, delimiter` | Масив | `TEXTSPLIT("20, 04, 79", ",") => ["20", " 04", " 79"]` | | LOWER | Перетворює рядок на нижній регістр. | `text` | Текст | `LOWER("Hello Teable") => "hello teable"` | | UPPER | Перетворює рядок на верхній регістр. | `text` | Текст | `UPPER("Hello Teable") => "HELLO TEABLE"` | | REPT | Повторює текст указану кількість разів. | `text, number` | Текст | `REPT("Hello!", 3) => "Hello!Hello!Hello!"` | | TRIM | Видаляє пробільні символи на початку й у кінці рядка. | `text` | Текст | `TRIM(" Hello ") => "Hello"` | | LEN | Підраховує кількість символів у рядку. | `text` | Число | `LEN("Hello") => 5` | | T | Повертає параметр, якщо він є текстом; інакше повертає порожнє значення. | `value` | Текст або порожнє значення | `T("Hello") => "Hello"` `T(100) => null` | | ENCODE\_URL\_COMPONENT | Замінює певні символи їх закодованими еквівалентами для створення URL- або URI-адрес. Не кодує: - \_ . \~ | `value` | Текст | `ENCODE_URL_COMPONENT("Hello Teable") => "Hello%20Teable"` | ## Логічні функції Логічні функції обробляють умови та логічні операції, як-от `IF`, `AND` і `OR`. | Назва функції | Опис | Вхідні дані | Результат | Приклад | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------ | --------------------------------------------------------------------------- | | IF | Повертає value1, якщо логічний параметр має значення true; інакше повертає value2. Можна використовувати для вкладених операторів IF і перевірки, чи порожні клітинки. | `logical, value1, value2` | Рядок \| Число \| Логічне значення \| Дата й час | `IF(2 > 1, "A", "B") => "A"` `IF(2 > 1, TRUE, FALSE) => TRUE` | | SWITCH | Зіставляє вхідний вираз із послідовністю значень і повертає відповідний результат. Може повернути значення за замовчуванням, якщо відповідності не знайдено. Часто може замінити вкладені формули IF(). | `expression, [pattern, result]..., [default]` | Рядок \| Число \| Логічне значення \| Дата й час | `SWITCH("B", "A", "Value A", "B", "Value B", "Default Value") => "Value B"` | | AND | Повертає true, якщо всі параметри мають значення true; інакше повертає false. | `logical1, [logical2, ...]` | Логічне значення | `AND(1 < 2, 5 > 3) => true` `AND(1 < 2, 5 < 3) => false` | | OR | Повертає true, якщо будь-який параметр має значення true. | `logical1, [logical2, ...]` | Логічне значення | `OR(1 < 2, 5 < 3) => true` `OR(1 > 2, 5 < 3) => false` | | XOR | Повертає true, якщо непарна кількість параметрів має значення true. | `logical1, [logical2, ...]` | Логічне значення | `XOR(1 < 2, 5 < 3, 8 < 10) => false` `XOR(1 > 2, 5 < 3, 8 < 10) => true` | | NOT | Інвертує логічне значення свого параметра. | `boolean` | Логічне значення | `NOT(1 < 2) => false` `NOT(1 > 2) => true` | | BLANK | Повертає значення null. Також можна використовувати для перевірки, чи порожнє Поле. | `-` | null | `BLANK() => null` `IF({Weight}=BLANK(), 1, 2) => 1` | | ERROR | Повертає значення помилки. | `message` | Помилка | `IF(2 > 3, "Yes", ERROR("Calculation")) => "#ERROR: Calculation"` | | IS\_ERROR | Повертає true, якщо вираз спричиняє помилку. | `expr` | Логічне значення | `IS_ERROR(ERROR()) => true` | ## Функції дати Функції дати обробляють і перетворюють значення дати й часу: отримують поточну дату, обчислюють різницю між датами та порівнюють дати. | Назва функції | Опис | Вхідні дані | Результат | Приклад | | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------- | | TODAY | Повертає поточну дату. | `-` | Дата й час | `TODAY() => "2023-09-08 00:00"` | | NOW | Повертає поточну дату й час. | `-` | Дата й час | `NOW() => "2023-09-08 16:50"` | | YEAR | Повертає чотиризначний рік дати. | `date` | Число | `YEAR("2023-09-08") => 2023` | | MONTH | Повертає місяць дати як число від 1 (січень) до 12 (грудень). | `date` | Число | `MONTH("2023-09-08") => 9` | | WEEKNUM | Повертає номер тижня року. | `date` | Число | `WEEKNUM("2023-09-08") => 36` | | WEEKDAY | Повертає день тижня як ціле число від 0 до 6. За бажанням можна вказати другий параметр ("Sunday" або "Monday"), щоб тиждень починався із цього дня. | `date, [startDayOfWeek]` | Число | `WEEKDAY("2023-09-08", "Monday") => 5` | | DAY | Повертає день місяця як число від 1 до 31. | `date` | Число | `DAY("2023-09-08") => 8` | | HOUR | Повертає годину дати як число від 0 (12:00am) до 23 (11:00pm). | `date` | Число | `HOUR("2023-09-08 16:50") => 16` | | MINUTE | Повертає хвилину дати як ціле число від 0 до 59. | `date` | Число | `MINUTE("2023-09-08 16:50") => 50` | | SECOND | Повертає секунди дати як ціле число від 0 до 59. | `date` | Число | `SECOND("2023-09-08 16:50:30") => 30` | | FROMNOW | Обчислює кількість днів між поточною та іншою датою. | `date, unit` | Число | `FROMNOW({Date}, "day") => 25` | | TONOW | Обчислює кількість днів між поточною та іншою датою. | `date, unit` | Число | `TONOW({Date}, "day") => 25` | | DATETIME\_DIFF | Повертає різницю між датами й часом у вказаних одиницях. Одиниця за замовчуванням — секунди. (Див. список позначень одиниць.) | `date1, date2, [unit]` | Число | `DATETIME_DIFF("2022-08-01", "2023-09-08", "day") => 403` | | WORKDAY | Повертає дату робочого дня зі зміщенням від початкової дати, виключаючи вказані святкові дні | `date, count, [holidayStr]` | Дата й час | `WORKDAY("2023-09-08", 200) => "2024-06-14 00:00:00"` | | WORKDAY\_DIFF | Повертає кількість робочих днів між date1 і date2. Робочі дні не включають вихідні та необов’язковий список святкових днів, оформлений як розділений комами рядок дат у форматі ISO. | `date1, date2, [holidayStr]` | Число | `WORKDAY_DIFF("2023-06-18", "2023-10-01") => 75` | | IS\_SAME | Порівнює дві дати з точністю до одиниці й визначає, чи вони однакові. Повертає true, якщо так, інакше — false. | `date1, date2, [unit]` | Логічне значення | `IS_SAME("2023-09-08", "2023-09-10") => false` | | IS\_AFTER | Визначає, чи date1 пізніша за date2. Повертає true, якщо так, інакше — false. | `date1, date2, [unit]` | Логічне значення | `IS_AFTER("2023-09-10", "2023-09-08") => true` `IS_AFTER("2023-09-10", "2023-09-08", "month") => false` | ## Функції масивів та інші функції Функції масивів та інші функції обробляють масиви зведення, усувають дублікати, об’єднують значення, очищають порожні значення й отримують ідентифікатори Записів. | Назва функції | Опис | Вхідні дані | Результат | Приклад | | -------------- | --------------------------------------------------------------------------------------------------------------------- | ----------------------- | --------- | ----------------------------------------------------------------------------- | | COUNTALL | Повертає кількість усіх елементів, включно з текстом і порожніми значеннями. | `value1, [value2, ...]` | Число | `COUNTALL(100, 200, "", "Teable", TRUE()) => 5` | | COUNTA | Повертає кількість непорожніх значень. Ця функція підраховує як числові, так і текстові значення. | `value1, [value2, ...]` | Число | `COUNTA(100, 200, 300, "", "Teable", TRUE) => 4` | | COUNT | Повертає кількість числових елементів. | `value1, [value2, ...]` | Число | `COUNT(100, 200, 300, "", "Teable", TRUE) => 3` | | ARRAY\_JOIN | Об’єднує масив елементів зведення в рядок за допомогою роздільника. | `array, [separator]` | Рядок | `ARRAY_JOIN(["Tom", "Jerry", "Mike"], "; ") => "Tom; Jerry; Mike"` | | ARRAY\_UNIQUE | Повертає лише унікальні елементи масиву. | `array` | Масив | `ARRAY_UNIQUE([1, 2, 3, 2, 1]) => [1, 2, 3]` | | ARRAY\_FLATTEN | Робить масив плоским, усуваючи всі рівні вкладеності. Усі елементи стають елементами одного масиву. | `array` | Масив | `ARRAY_FLATTEN([1, 2, " ", 3, true], ["ABC"]) => [1, 2, 3, " ", true, "ABC"]` | | ARRAY\_COMPACT | Видаляє з масиву порожні рядки та значення null. Зберігає "false" і рядки з одним або кількома пробільними символами. | `array` | Масив | `ARRAY_COMPACT([1, 2, 3, "", null, "ABC"]) => [1, 2, 3, "ABC"]` | | RECORD\_ID | Повертає ідентифікатор поточного Запису. | `-` | Рядок | `RECORD_ID() => "recxxxxxx"` |