Числові функції
Числові функції виконують математичні операції, статистичні обчислення та форматування чисел.| Назва функції | Опис | Вхідні дані | Результат | Приклад |
|---|---|---|---|---|
| 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" |