--- metadata: - name: generator content: Diplodoc Platform v5.50.3 alternate: - https://divkit.tech/docs/en/concepts/functions.md - https://divkit.tech/docs/ru/concepts/functions.md --- > **Documentation Index:** Fetch the complete configuration index at https://divkit.tech/docs/ru/llms.txt # Встроенные функции ## Преобразование типов {#std} #| || **Функция** | **Описание** || || `toBoolean(integer) boolean` | Преобразует аргумент к логическому типу. Возвращает `true` при значении аргумента `1`, `false` при значении аргумента `0`, ошибку при других значениях аргумента.
Аргумент: значение типа `integer`. || || `toBoolean(string) boolean` | Преобразует аргумент к логическому типу. Возвращает `true` при значении аргумента `"true"`, `false` при значении аргумента `"false"`, ошибку при других значениях аргумента.
Аргумент: значение типа `string`. || || `toInteger(boolean) integer` | Преобразует аргумент в целое число. Возвращает `1` при значении аргумента `true`, `0` при значении аргумента `false`.
Аргумент: значение типа `boolean`. || || `toInteger(number) integer` | Преобразует аргумент в целое число. Округляет значение в меньшую сторону. Возвращает значение типа `integer`.
Аргумент: значение типа `number`. || || `toInteger(string) integer` | Преобразует аргумент в целое число. Возвращает значение типа `integer`.
Аргумент: значение типа `string`. || || `toNumber(integer) number` | Преобразует аргумент в число с плавающей точкой. Возвращает значение типа `number`.
Аргумент: значение типа `integer`. || || `toNumber(string) number` | Преобразует аргумент в число с плавающей точкой. Возвращает значение типа `number`.
Аргумент: значение типа `string`. || || `toString(boolean) string` | Преобразует аргумент в строку. Возвращает значение типа `string`.
Аргумент: значение типа `boolean`. || || `toString(integer) string` | Преобразует аргумент в строку. Возвращает значение типа `string`.
Аргумент: значение типа `integer`. || || `toString(number) string` | Преобразует аргумент в строку. Возвращает значение типа `string`.
Аргумент: значение типа `number`. || || `encodeUri(string) string` | Кодирует строку в формат `application/x-www-form-urlencoded`. Возвращает закодированное значение типа `string`.
Аргумент: значение типа `string`. || || `decodeUri(string) string` | Декодирует строку формата `application/x-www-form-urlencoded`. Возвращает декодированное значение типа `string`.
Аргумент: значение типа `string`. || |# ## Математические операции {#math} Математические операции #| || **Функция** | **Описание** || || `div(integer, integer) integer` | Вычисляет частное от деления первого числа на второе. Результат округляется в меньшую сторону, например `div(5,2)` → `2`. Возвращает значение типа `integer`.
Аргументы: 1 — делимое типа `integer`, 2 — делитель типа `integer`. || || `div(number, number) number` | Вычисляет частное от деления первого числа на второе. Возвращает значение типа `number`.
Аргументы: 1 — делимое типа `number`, 2 — делитель типа `number`. || || `mod(integer, integer) integer` | Вычисляет остаток от деления первого числа на второе. Возвращает значение типа `integer`.
Аргументы: 1 — делимое типа `integer`, 2 — делитель типа `integer`. || || `mul(vararg integer) integer` | Вычисляет произведение аргументов. Возвращает значение типа `integer`.
Аргументы: несколько значений типа `integer`. || || `mul(vararg number) number` | Вычисляет произведение аргументов. Возвращает значение типа `number`.
Аргументы: несколько значений типа `number`. || || `sub(vararg integer) integer` | Вычисляет разность от вычитания аргументов. Возвращает значение типа `integer`.
Аргументы: 1 — значение типа `integer`, из которого вычитаются остальные аргументы; остальные аргументы — одно или несколько значений типа `integer`, вычитаемые из аргумента 1. || || `sub(vararg number) number` | Вычисляет разность от вычитания аргументов. Возвращает значение типа `number`.
Аргументы: 1 — значение типа `number`, из которого вычитаются остальные аргументы; остальные аргументы — одно или несколько значений типа `number`, вычитаемые из аргумента 1. || || `sum(vararg integer) integer` | Вычисляет сумму аргументов. Возвращает значение типа `integer`.
Аргументы: несколько значений типа `integer`. || || `sum(vararg number) number` | Вычисляет сумму аргументов. Возвращает значение типа `number`.
Аргументы: несколько значений типа `number`. || || `abs(number) number` | Вычисляет абсолютное значение аргумента. Возвращает значение типа `number`.
Аргумент: значение типа `number`. || || `abs(integer) integer` | Вычисляет абсолютное значение аргумента. Возвращает значение типа `integer`.
Аргумент: значение типа `integer`. || || `max(vararg number) number` | Вычисляет максимальное значение среди аргументов. Возвращает значение типа `number`.
Аргументы: несколько значений типа `number`. || || `max(vararg integer) integer` | Вычисляет максимальное значение среди аргументов. Возвращает значение типа `integer`.
Аргументы: несколько значений типа `integer`. || || `min(vararg integer) integer` | Вычисляет минимальное значение среди аргументов. Возвращает значение типа `integer`.
Аргументы: несколько значений типа `integer`. || || `min(vararg number) number` | Вычисляет минимальное значение среди аргументов. Возвращает значение типа `number`.
Аргументы: несколько значений типа `number`. || || `maxNumber() number` | Вычисляет максимальное значение для типа `number`. Возвращает значение типа `number`.
Аргументы отсутствуют. || || `maxInteger() integer` | Вычисляет максимальное значение для типа `integer`. Возвращает значение типа `integer`.
Аргументы отсутствуют. || || `minNumber() number` | Вычисляет минимальное значение для типа `number`. Возвращает значение типа `number`.
Аргументы отсутствуют. || || `minInteger() integer` | Вычисляет минимальное значение для типа `integer`. Возвращает значение типа `integer`.
Аргументы отсутствуют. || || `round(number) number` | Округляет значение аргумента. Например, 1.49 → 1.0, 1.5 → 2.0. Возвращает значение типа `number`.
Аргумент: значение типа `number`. || || `floor(number) number` | Округляет значение аргумента в меньшую сторону. Например, 1.49 → 1.0, 1.5 → 1.0. Возвращает значение типа `number`.
Аргумент: значение типа `number`. || || `ceil(number) number` | Округляет значение аргумента в большую сторону. Например, 1.49 → 2.0, 1.5 → 2.0. Возвращает значение типа `number`.
Аргумент: значение типа `number`. || || `signum(number) number` | Вычисляет знак аргумента. Возвращает `-1.0` при отрицательном значении, `0.0` при нулевом значении, `1.0` при положительном значении.
Аргумент: значение типа `number`. || || `signum(integer) integer` | Вычисляет знак аргумента. Возвращает `-1` при отрицательном значении, `0` при нулевом значении, `1` при положительном значении.
Аргумент: значение типа `integer`. || || `copySign(number, number) number` | Вычисляет число с абсолютным значением первого аргумента и знаком второго аргумента. Возвращает значение типа `number`.
Аргументы: 1 — значение типа `number`, от которого берется абсолютное значение; 2 — значение типа `number`, от которого берется знак. || || `copySign(integer, integer) integer` | Вычисляет число с абсолютным значением первого аргумента и знаком второго аргумента. Возвращает значение типа `integer`.
Аргументы: 1 — значение типа `integer`, от которого берется абсолютное значение; 2 — значение типа `integer`, от которого берется знак. || || `pi() number` | Возвращает значение числа `π`: отношение длины окружности круга к его диаметру. Возвращает значение типа `number`. || || `toRadians(number) number` | Преобразует угол, измеренный в градусах, в приблизительно эквивалентный угол, измеренный в радианах. Возвращает значение типа `number`.
Аргумент: угол в градусах (значение типа `number`). || || `toDegrees(number) number` | Преобразует угол, измеренный в радианах, в приблизительно эквивалентный угол, измеренный в градусах. Возвращает значение типа `number`.
Аргумент: угол в радианах (значение типа `number`). || || `sin(number) number` | Вычисляет синус угла в радианах.
Аргумент: угол в радианах. || || `cos(number) number` | Вычисляет косинус угла в радианах.
Аргумент: угол в радианах. || || `tan(number) number` | Вычисляет тангенс угла в радианах.
Аргумент: угол в радианах. || || `asin(number) number` | Вычисляет арксинус для заданного числа. Значение аргумента должно находиться в интервале [-1, 1], иначе функция завершится с ошибкой.
Аргумент: значение типа `number`. || || `acos(number) number` | Вычисляет арккосинус для заданного числа. Значение аргумента должно находиться в интервале [-1, 1], иначе функция завершится с ошибкой.
Аргумент: значение типа `number`. || || `atan(number) number` | Вычисляет арктангенс для заданного числа.
Аргумент: значение типа `number`. || || `atan2(number, number) number` | Вычисляет угол в радианах между положительной осью x и точкой с координатами (x, y).
Аргументы: 1 — значение типа `number`, представляющее координату y; 2 — значение типа `number`, представляющее координату x. || |# ## Операции со строками {#strings} #| || **Функция** | **Описание** || || `len(string) integer` | Вычисляет длину заданной строки. Возвращает значение типа `integer`.
Аргумент: значение типа `string`. || || `contains(string, string) boolean` | Определяет, содержит ли строка (аргумент 1) заданную подстроку (аргумент 2). Возвращает значение типа `boolean`.
Аргументы: 1 — исходная строка, тип `string`; 2 — подстрока для поиска, тип `string`. || || `substring(string, integer, integer) string` | Вырезает из строки (аргумент 1) фрагмент, границы которого заданы аргументами 2 и 3. Возвращает значение типа `string`.
Аргументы: 1 — исходная строка, тип `string`; 2 — позиция левой границы фрагмента, тип `integer`; 3 — позиция правой границы фрагмента, тип `integer`. || || `replaceAll(string, string, string) string` | Ищет в исходной строке (аргумент 1) все вхождения подстроки (аргумент 2) и заменяет их третьей строкой (аргумент 3). Возвращает значение типа `string` — исходную строку с выполненными заменами.
Аргументы: 1 — исходная строка, тип `string`; 2 — подстрока для поиска, тип `string`; 3 — строка для замены всех вхождений, тип `string`. || || `index(string, string) integer` | Вычисляет позицию первого вхождения подстроки (аргумент 2) в строке (аргумент 1). Возвращает значение типа `integer`: позицию первого вхождения или `-1`, если подстрока не найдена.
Аргументы: 1 — исходная строка, тип `string`; 2 — подстрока для поиска, тип `string`. || || `lastIndex(string, string) integer` | Вычисляет позицию последнего вхождения подстроки (аргумент 2) в строке (аргумент 1). Возвращает значение типа `integer`: позицию последнего вхождения или `-1`, если подстрока не найдена.
Аргументы: 1 — исходная строка, тип `string`; 2 — подстрока для поиска, тип `string`. || || `trim(string) string` | Удаляет пробелы в начале и в конце заданной строки. Возвращает значение типа `string`.
Аргумент: значение типа `string`. || || `trimLeft(string) string` | Удаляет пробелы в начале заданной строки. Возвращает значение типа `string`.
Аргумент: значение типа `string`. || || `trimRight(string) string` | Удаляет пробелы в конце заданной строки. Возвращает значение типа `string`.
Аргумент: значение типа `string`. || || `toUpperCase(string) string` | Преобразует заданную строку в верхний регистр. Возвращает значение типа `string`.
Аргумент: значение типа `string`. || || `toLowerCase(string) string` | Преобразует заданную строку в нижний регистр. Возвращает значение типа `string`.
Аргумент: значение типа `string`. || || `padStart(string, integer, string) string` | Дополняет строку до заданной длины, добавляя в начало строки указанные символы. Возвращает значение типа `string`.
Аргументы: 1 — исходная строка, тип `string`; 2 — длина строки, которую требуется получить, тип `integer`; 3 — символы, которые требуется добавить в начало строки, тип `string`.
Например: `"@{padStart('0', 4, '12')}` → `"1210"` || || `padStart(integer, integer, string) string` | Конвертирует число в строку и дополняет полученную строку до заданной длины, добавляя в начало строки указанные символы. Возвращает значение типа `string`.
Аргументы: 1 — исходное число, тип `integer`; 2 — длина строки, которую требуется получить, тип `integer`; 3 — символы, которые требуется добавить в начало строки, тип `string`.
Например: `"@{padStart(0, 4, '12')}` → `"1210"` || || `padEnd(string, integer, string) string` | Дополняет строку до заданной длины, добавляя в конец строки указанные символы. Возвращает значение типа `string`.
Аргументы: 1 — исходная строка, тип `string`; 2 — длина строки, которую требуется получить, тип `integer`; 3 — символы, которые требуется добавить в конец строки, тип `string`.
Например: `"@{padEnd('0', 4, '12')}”` → `“0121”` || || `padEnd(integer, integer, string) string` | Конвертирует число в строку и дополняет полученную строку до заданной длины, добавляя в конец строки указанные символы. Возвращает значение типа `string`.
Аргументы: 1 — исходное число, тип `integer`; 2 — длина строки, которую требуется получить, тип `integer`; 3 — символы, которые требуется добавить в конец строки, тип `string`.
Например: `"@{padEnd(0, 4, '12')}”` → `“0121”` || |# ## Операции с цветами {#colors} #| || **Функция** | **Описание** || || `getColorAlpha(string) number` | Вычисляет значение альфа-канала заданного цвета. Возвращает значение типа `number` в интервале от `0.0` до `1.0`.
Аргумент: значение цвета в шестнадцатеричном формате, тип `string`. || || `getColorRed(string) number` | Вычисляет значение красного канала заданного цвета. Возвращает значение типа `number` в интервале от `0.0` до `1.0`.
Аргумент: значение цвета в шестнадцатеричном формате, тип `string`. || || `getColorGreen(string) number` | Вычисляет значение зеленого канала заданного цвета. Возвращает значение типа `number` в интервале от `0.0` до `1.0`.
Аргумент: значение цвета в шестнадцатеричном формате, тип `string`. || || `getColorBlue(string) number` | Вычисляет значение синего канала заданного цвета. Возвращает значение типа `number` в интервале от `0.0` до `1.0`.
Аргумент: значение цвета в шестнадцатеричном формате, тип `string`. || || `setColorAlpha(string, number) string` | Устанавливает значение альфа-канала для заданного цвета. Возвращает значение цвета в шестнадцатеричном формате, тип `string`. Например, `'#FFAABBCC'`.
Аргументы: 1— значение цвета в шестнадцатеричном формате, тип `string`; 2 — значение альфа-канала в интервале от `0.0` до `1.0`, тип `number`. || || `setColorRed(string, number) string` | Устанавливает значение красного канала для заданного цвета. Возвращает значение цвета в шестнадцатеричном формате, тип `string`. Например, `'#FFAABBCC'`.
Аргументы: 1— значение цвета в шестнадцатеричном формате, тип `string`; 2 — значение красного канала в интервале от `0.0` до `1.0`, тип `number`. || || `setColorGreen(string, number) string` | Устанавливает значение зеленого канала для заданного цвета. Возвращает значение цвета в шестнадцатеричном формате, тип `string`. Например, `'#FFAABBCC'`.
Аргументы: 1— значение цвета в шестнадцатеричном формате, тип `string`; 2 — значение зеленого канала в интервале от `0.0` до `1.0`, тип `number`. || || `setColorBlue(string, number) string` | Устанавливает значение синего канала для заданного цвета. Возвращает значение цвета в шестнадцатеричном формате, тип `string`. Например, `'#FFAABBCC'`.
Аргументы: 1— значение цвета в шестнадцатеричном формате, тип `string`; 2 — значение синего канала в интервале от `0.0` до `1.0`, тип `number`. || || `argb(number, number, number, number) string` | Формирует код цвета из заданных значений альфа, красного, зеленого, синего каналов. Возвращает значение цвета в шестнадцатеричном формате, тип `string`. Например, `'#FFAABBCC'`.
Аргументы: 1— значение альфа-канала в интервале от `0.0` до `1.0`, тип `number`; 2 — значение красного канала в интервале от `0.0` до `1.0`, тип `number`; 3 — значение зеленого канала в интервале от `0.0` до `1.0`, тип `number`; 4 — значение синего канала в интервале от `0.0` до `1.0`, тип `number`. || || `rgb(number, number, number) string` | Формирует код цвета из заданных значений красного, зеленого, синего каналов. Устанавливает значение альфа-канала `1.0`. Возвращает значение цвета в шестнадцатеричном формате, тип `string`. Например, `'#FFAABBCC'`.
Аргументы: 1 — значение красного канала в интервале от `0.0` до `1.0`, тип `number`; 2 — значение зеленого канала в интервале от `0.0` до `1.0`, тип `number`; 3 — значение синего канала в интервале от `0.0` до `1.0`, тип `number`. || || `alphaBlend(string, string) string` | Смешивает два цвета с учетом альфа-канала. Использует стандартный алгоритм композиции альфа-смешивания, совместимый с Android и iOS. Возвращает значение цвета в шестнадцатеричном формате, тип `string`.
Аргументы: 1 — цвет фона, тип `string`; 2 — цвет переднего плана, тип `string`. || |# ## Операции с датой и временем {#datetime} #| || **Функция** | **Описание** || || `parseUnixTime(integer) datetime` | Формирует значение даты и времени по заданному значению Unix-времени. Возвращает значение типа `datetime`.
Аргумент: время UTC в секундах от полуночи 1 января 1970 года, тип `integer`. || || `nowLocal() datetime` | Формирует значение даты и времени на текущий момент. Возвращает значение типа `datetime`.
Аргументы отсутствуют. || || `addMillis(datetime, milliseconds: integer) datetime` | Добавляет заданное количество миллисекунд к исходным дате и времени. Возвращает значение типа `datetime`.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — количество миллисекунд, тип `integer`. || || `setYear(datetime, year: integer) datetime` | Устанавливает год в исходной дате. Возвращает значение типа `datetime` с заданным годом.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — год, тип `integer`. || || `setMonth(datetime, month: integer) datetime` | Устанавливает месяц в исходной дате. Возвращает значение типа `datetime` с заданным месяцем.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — номер месяца от `1` до `12`, тип `integer`. || || `setDay(datetime, monthDay: integer) datetime` | Устанавливает день месяца в исходной дате. Возвращает значение типа `datetime` с заданным днем.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — номер дня в месяце, тип `integer`. || || `setHours(datetime, hours: integer) datetime` | Устанавливает час в исходных дате и времени. Возвращает значение типа `datetime` с заданным часом.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — значение часа, тип `integer`. || || `setMinutes(datetime, minutes: integer) datetime` | Устанавливает минуты в исходных дате и времени. Возвращает значение типа `datetime` с заданными минутами.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — значение минут, тип `integer`. || || `setSeconds(datetime, seconds: integer) datetime` | Устанавливает секунды в исходных дате и времени. Возвращает значение типа `datetime` с заданными секундами.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — значение секунд, тип `integer`. || || `setMillis(datetime, milliseconds: integer) datetime` | Устанавливает миллисекунды в исходных дате и времени. Возвращает значение типа `datetime` с заданными миллисекундами.
Аргументы: 1 — исходные дата и время, тип `datetime`; 2 — значение миллисекунд, тип `integer`. || || `getYear(datetime) integer` | Вычисляет значение года из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getMonth(datetime) integer` | Вычисляет порядковый номер месяца из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getDay(datetime) integer` | Вычисляет порядковый номер дня месяца из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getDayOfWeek(datetime) integer` | Вычисляет день недели из исходных даты и времени. Значение `7` соответствует воскресенью. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getHours(datetime) integer` | Вычисляет значение часа из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getMinutes(datetime) integer` | Вычисляет значение минут из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getSeconds(datetime) integer` | Вычисляет значение секунд из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getMillis(datetime) integer` | Вычисляет значение миллисекунд из исходных даты и времени. Возвращает значение типа `integer`.
Аргумент: исходные дата и время, тип `datetime`. || || `getIntervalSeconds(integer) integer` | Переводит указанный интервал в миллисекундах в формат `Dd HH:MM:SS` (дни, часы, минуты, секунды) и вычисляет значение секунд. Возвращает значение типа `integer` в интервале от `0` до `59`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalSeconds(100000000)}` → `40` || || `getIntervalTotalSeconds(integer) integer` | Переводит указанный интервал времени из миллисекунд в секунды с округлением в меньшую сторону. Возвращает количество секунд, тип `integer`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalTotalSeconds(100000000)}` → `100000` || || `getIntervalMinutes(integer) integer` | Переводит указанный интервал в миллисекундах в формат `Dd HH:MM:SS` (дни, часы, минуты, секунды) и вычисляет значение минут. Возвращает значение типа `integer` в интервале от `0` до `59`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalMinutes(100000000)}` → `46` || || `getIntervalTotalMinutes(integer) integer` | Переводит указанный интервал времени из миллисекунд в минуты с округлением в меньшую сторону. Возвращает количество минут, тип `integer`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalTotalMinutes(100000000)}` → `1666` || || `getIntervalHours(integer) integer` | Переводит указанный интервал в миллисекундах в формат `Dd HH:MM:SS` (дни, часы, минуты, секунды) и вычисляет значение часов. Возвращает значение типа `integer` в интервале от `0` до `23`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalHours(100000000)}` → `3` || || `getIntervalTotalHours(integer) integer` | Переводит указанный интервал времени из миллисекунд в часы с округлением в меньшую сторону. Возвращает количество часов, тип `integer`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalTotalHours(100000000)}` → `27` || || `getIntervalTotalDays(integer) integer` | Переводит указанный интервал времени из миллисекунд в дни с округлением в меньшую сторону. Возвращает количество дней, тип `integer`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalTotalDays(1000000000)}` → `11` || || `getIntervalTotalWeeks(integer) integer` | Переводит указанный интервал времени из миллисекунд в недели с округлением в меньшую сторону. Возвращает количество недель, тип `integer`.
Аргумент: длительность интервала в миллисекундах, тип `integer`.
Например, `@{getIntervalTotalWeeks(1000000000)}` → `1` || || `getTimestamp(datetime) integer` | Преобразует объект DateTime в временную метку в миллисекундах. Возвращает значение типа `integer`.
Аргумент: значение даты и времени, тип `datetime`. || |# ## Узнать больше {#troubleshooting} Вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: [https://t.me/divkit_community_ru](https://t.me/divkit_community_ru). [Репозиторий DivKit](https://github.com/divkit/divkit)