Встроенные функции

Преобразование типов

Функция

Описание

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.

Математические операции

Математические операции

Функция

Описание

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, от которого берется знак.

Операции со строками

Функция

Описание

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”

Операции с цветами

Функция

Описание

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.

Операции с датой и временем

Функция

Описание

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

Узнать больше

Следите за новостями DivKit в Telegram-канале: http://t.me/divkit_news.

Также вы можете обсуждать интересующие вас темы в сообществе пользователей DivKit в Telegram: https://t.me/divkit_community_ru.

Репозиторий DivKit