Формулы в полях

Тип

Пример

Примечание

Число

1, -5.75, 3.14

Десятичный разделитель — точка.

Строка

'Текст', "Текст"

Можно использовать одинарные или двойные кавычки.

Булево значение

true, false

Логические константы.

Дата

DATE(2024, 12, 31)

Создается с помощью функции DATE.

Массив

[1, 2, 3], ["Да", "Нет"]

Набор значений в квадратных скобках.

Тип поля

Тип в формуле

Значение по умолчанию

Текст, Текстовый редактор

Строка

"" (пустая строка)

Число, Дата

Число, Дата

NULL (пустое значение)

Прогресс, Оценка звездами

Число

0

Переключатель

Булево значение

false

Статус, Набор галочек

Массив строк

[] (пустой массив)

Оператор

Пример

Результат

Описание

+

1 + 2

3

Сложение чисел или конкатенация строк.

-

5 - 2

3

Вычитание.

*

3 * 5

15

Умножение.

/

10 / 2

5

Деление.

%

12 % 7

5

Остаток от деления.

^

12 ^ 2

144

Возведение в степень.

Оператор

Пример

Результат

Описание

&

5 & "2"

"52"

Склеивание (конкатенация) строк.

Оператор

Пример

Возвращаемое значение

Поддерживаемые типы (сравнение)

>

1 > 2

false

Прямое сравнение: Число, Строка, Дата, Булевый тип. Для остальных типов: преобразуются в строку и сравниваются.

<

1 < 2

true

Прямое сравнение: Число, Строка, Дата, Булевый тип. Для остальных типов: преобразуются в строку и сравниваются.

>=

1 >= 2

false

Прямое сравнение: Число, Строка, Дата, Булевый тип. Для остальных типов: преобразуются в строку и сравниваются.

<=

1 <= 2

true

Прямое сравнение: Число, Строка, Дата, Булевый тип. Для остальных типов: преобразуются в строку и сравниваются.

==

1 == 2

false

Прямое сравнение: Число, Строка, Дата, Булевый тип. Для остальных типов: преобразуются в строку и сравниваются.

!=

1 != 2

true

Прямое сравнение: Число, Строка, Дата, Булевый тип. Для остальных типов: преобразуются в строку и сравниваются.

!

!(1 > 2)

true

Применяется к булевому значению (результату выражения).

&&

(1 > 2) && (3 > 2)

false

Работает с булевыми значениями (результатами условий).

||

(1 > 2) || (3 > 2)

true

Работает с**:** Булевыми значениями (результатами условий).

Функция

Описание

Пример

CONCAT(строка1, строка2, ...)

Склеивает все аргументы в одну строку.

CONCAT("Итог: ", {Сумма})

JOIN([массив], разделитель)

Объединяет элементы массива в строку через разделитель.

JOIN({Теги}, ", ")

LEFT(строка, количество)

Возвращает указанное количество символов с начала строки.

LEFT("Привет", 3) → "При"

LEN(строка)

Возвращает длину строки.

LEN("abc") → 3

LOWER(строка), UPPER(строка)

Приводит строку к нижнему/верхнему регистру.

UPPER("текст") → "ТЕКСТ"

REGEXMATCH(строка, regex, ?режим)

Проверяет, соответствует ли строка регулярному выражению. Возвращает true/false.

REGEXMATCH("test@mail.ru", "@") → true

REGEXREPLACE(строка, regex, замена, ?режим)

Заменяет совпадения по регулярному выражению.

REGEXREPLACE("123-456", "\d", "X") → "XXX-XXX"

REPEAT(строка, количество)

Повторяет строку указанное количество раз.

REPEAT("a", 3) → "aaa"

REPLACE(строка, что_менять, на_что)

Заменяет все вхождения подстроки.

REPLACE("a-b-c", "-", "/") → "a/b/c"

RIGHT(строка, количество)

Возвращает указанное количество символов с конца строки.

RIGHT("Привет", 3) → "вет"

SEARCH(строка, подстрока)

Возвращает позицию первого вхождения подстроки (с 0) или -1.

SEARCH("привет", "иве") → 2

SUBSTRING(строка, начало, ?конец)

Возвращает часть строки. Индексы с 0.

SUBSTRING("abcdef", 1, 4) → "bcd"

TOSTRING(значение)

Преобразует любое значение в строку.

TOSTRING(123) → "123"

TRIM(направление, символы, строка)

Удаляет указанные символы с начала/конца строки. Направление: "leading", "trailing", "both".

TRIM("both", " ", " текст ")

Функция

Описание

Пример

ABS(число)

Модуль числа.

ABS(-5) → 5

ACOS(число), ASIN(число), ATAN(число), ACOT(число)

Обратные тригонометрические функции (арккосинус, арксинус, арктангенс, арккотангенс).

ACOS(0.5) → 1.047

AVERAGE(число1, число2, ...)

Среднее арифметическое.

AVERAGE(1, 2, 3) → 2

CEIL(число, ?знаков)

Округление вверх.

CEIL(5.1) → 6

COS(число), SIN(число), TAN(число), COT(число)

Тригонометрические функции (косинус, синус, тангенс, котангенс).

COS(0) → 1

EXP(число)

Экспонента (e в степени число).

EXP(1) → 2.718

FIXED(число, ?знаков)

Форматирует число в строку с разделителями.

FIXED(1000.5, 1) → "1 000,5"

FLOOR(число, ?знаков)

Округление вниз.

FLOOR(5.9) → 5

LN(число)

Натуральный логарифм.

LN(2.718) → 1

LOG(число, ?основание)

Логарифм по указанному основанию (по умолчанию e).

LOG(100, 10) → 2

LOG10(число)

Десятичный логарифм.

LOG10(100) → 2

MAX(число1, число2, ...)

Максимальное значение.

MAX(1, 5, 3) → 5

MIN(число1, число2, ...)

Минимальное значение.

MIN(1, 5, 3) → 1

MOD(делимое, делитель)

Остаток от деления.

MOD(10, 3) → 1

PI()

Число π (пи).

PI() → 3.142

POWER(основание, степень)

Возведение в степень.

POWER(3, 2) → 9

RANDOM()

Случайное число от 0 до 1.

RANDOM()

ROUND(число, ?знаков)

Округление до ближайшего.

ROUND(5.67, 1) → 5.7

SQRT(число)

Квадратный корень.

SQRT(16) → 4

SUM(число1, число2, ...)

Сумма значений.

SUM(1, 2, {Цена})

TONUMBER(значение)

Преобразует значение в число.

TONUMBER("123") → 123

Функция

Описание

Пример

DATE(год, месяц, день, ?час, ?мин, ?сек)

Создает дату.

DATE(2024, 12, 31)

DATEADD(дата, количество, единица)

Добавляет интервал к дате. Единицы: "d" (дни), "m" (месяцы), "y" (годы) и др.

DATEADD({ДатаСтарта}, 7, "d")

DATESUB(дата, интервал, единица)

Вычитает интервал из даты. Единицы: "d" (дни), "m" (месяцы), "y" (годы) и др.

DATESUB({Дата}, 7, "d")

DATEDIFF(дата1, дата2, единица)

Разница между датами.

DATEDIFF({Конец}, {Начало}, "d")

DATEFORMAT(дата, формат)

Форматирует дату в строку. Список форматов.

DATEFORMAT(NOW(), 'DD.MM.YYYY')

DATEPARSE(текст, формат)

Парсит строку в дату по указанному формату.

DATEPARSE("31.12.2024", "DD.MM.YYYY")

DAY(дата), MONTH(дата), YEAR(дата)

Извлекает компонент даты (день, месяц, год).

MONTH({Дата})

HOUR(дата), MINUTE(дата), SECOND(дата)

Извлекает компонент времени (час, минута, секунда).

HOUR({Дата})

QUARTER(дата)

Извлекает квартал года (1-4).

QUARTER({Дата})

WEEKDAY(дата)

День недели (1-понедельник).

WEEKDAY({Дата})

WEEKNUM(дата)

Номер недели в году.

WEEKNUM({Дата})

STARTOF(дата, единица), ENDOF(дата, единица)

Сдвиг к началу/концу периода (дня, месяца, года).

STARTOF({Дата}, "m")

SETYEAR(дата, год), SETMONTH(дата, месяц), SETDAY(дата, день)

Устанавливает компонент даты (год, месяц, день).

SETYEAR({Дата}, 2025)

SETQUARTER(дата, квартал), SETWEEKDAY(дата, день), SETWEEKNUM(дата, неделя)

Устанавливает квартал, день недели, номер недели.

SETQUARTER({Дата}, 2)

SETHOUR(дата, час), SETMINUTE(дата, минута), SETSECOND(дата, секунда)

Устанавливает компонент времени (час, минута, секунда).

SETHOUR({Дата}, 12)

SETTIME(дата, время)

Устанавливает время (в миллисекундах с начала дня).

SETTIME({Дата}, 43200000)

TIMESTAMP(дата)

Преобразует дату в числовой timestamp (миллисекунды с 1 января 1970).

TIMESTAMP({Дата})

Функция

Описание

Пример

IF(условие, значение_истина, значение_ложь)

Возвращает одно из двух значений в зависимости от условия.

IF({Сумма} > 1000, "Крупный", "Мелкий")

ISEMPTY(значение)

Проверяет, пустое ли значение (или является ошибкой).

ISEMPTY({Цена})

Функция

Описание

Пример

COUNT(массив)

Количество элементов в массиве.

COUNT({Статус})

FILTER(массив, элемент, ?attr)

Фильтрует массив по условию.

FILTER({Статус}, "Готово", "name")

FIND(массив, элемент, ?attr)

Ищет элемент в массиве, возвращает его.

FIND({Статус}, "Готово", "name")

ID(массив), NAME(массив)

Массив из ID или названий элементов.

NAME({Статус})

INDEX(массив, индекс, ?attr)

Элемент массива по индексу (с 0).

INDEX({Чекбоксы}, 0, "name")

SLICE(массив, начало, ?конец, ?attr)

Возвращает часть массива.

SLICE({Статус}, 0, 2)

SORT(массив, ?режим, ?attr)

Сортирует массив.

SORT({Статус}, 1)

UNIQUE(массив, ?attr)

Возвращает массив уникальных элементов.

UNIQUE({Статус}, "name")

Функция

Описание

RECORDID()

Возвращает внутренний ID (dbid) текущей записи.

CATALOGID()

Возвращает ID текущего каталога.

Название поля

Тип поля

Формула

Количество

Число

—

Цена за единицу

Число

—

Скидка %

Число

—

НДС

Число

—

Стоимость без скидки

Число

{Количество} * {Цена за единицу}

Сумма скидки

Число

{Стоимость без скидки} * {Скидка %} / 100

Стоимость со скидкой

Число

{Стоимость без скидки} - {Сумма скидки}

Сумма НДС

Число

{Стоимость со скидкой} * {НДС} / 100

Итоговая сумма

Число

{Стоимость со скидкой} + {Сумма НДС}