Дополнительные функции в схемах автоматизации

Содержание раздела:

В данном разделе при описании функций приняты следующие обозначения:

  • Типы значений, которые принимает аргумент, указаны в угловых скобках.

  • Перечень необязательных аргументов заключается в квадратные скобки. При вызове функции квадратные скобки вводить не нужно.

  • После :: в угловых скобках указаны типы значений, которые возвращает функция.

Функции для работы с числами

roundTo

Округляет число x до n знаков после запятой. Если n не указано, округляет до ближайшего целого.

Спецификация функции

roundTo(x: <Float>, [n: <Integer>])
:: <Float>
Аргумент Тип Описание Обязателен

x

Float

Число, которое требуется округлить.

да

n

Integer

Количество знаков, до которого требуется округлить. Значение по умолчанию — 0.

нет

Пример

Исходный код
roundTo(3.14159, 2)
Результат
3.14

percent

Вычисляет, сколько процентов составляет доля part от числа total.

Если total = 0, функция вернет null.

Спецификация функции

percent(part: <Float | Integer | Decimal>, total: <Float | Integer | Decimal>)
:: <Float | null>
Аргумент Тип Описание Обязателен

part

Float Integer Decimal

Значение доли.

да

total

Float Integer Decimal

Значение целого.

да

Пример

Исходный код
percent(25, 200)
Результат
12.5

randInt

Возвращает случайное целое число от min до max включительно.

Спецификация функции

randInt(min: <Integer>, max: <Integer>)
:: <Integer>
Аргумент Тип Описание Обязателен

min

Integer

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

да

max

Integer

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

да

Пример

Исходный код
randInt(1, 10)
Результат
7

Функции для работы со строками

strConcat

Объединяет строки в списке args.

Спецификация функции

strConcat(args: <List [String]>)
:: <String>
Аргумент Тип Описание Обязателен

args

List [String]

Список строк, разделенных запятой.

да

Пример

Исходный код
strConcat("Hello", " ", "world")
Результат
Hello world

strUpper

Переводит строку s в верхний регистр.

Спецификация функции

strUpper(s: <String>)
:: <String>
Аргумент Тип Описание Обязателен

s

String

Строка, которую требуется перевести в верхний регистр.

да

Пример

Исходный код
strUpper("Hello")
Результат
HELLO

strLower

Переводит строку s в нижний регистр.

Спецификация функции

strLower(s: <String>)
:: <String>
Аргумент Тип Описание Обязателен

s

String

Строка, которую требуется перевести в нижний регистр.

да

Пример

Исходный код
strLower("Hello")
Результат
hello

strTrim

Удаляет пробельные символы с левого и правого края строки s.

Спецификация функции

strTrim(s: <String>)
:: <String>
Аргумент Тип Описание Обязателен

s

String

Строка, для которой требуется удалить пробельные символы.

да

Пример

Исходный код
strTrim("  Hello world   ")
Результат
Hello world

strLength

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

Спецификация функции

strLength(s: <String>)
:: <Integer>
Аргумент Тип Описание Обязателен

s

String

Строка, количество символов в которой требуется подсчитать.

да

Пример

Исходный код
strLength("Hello world")
Результат
11

strStartsWith

Проверяет, начинается ли строка s с префикса prefix.

Спецификация функции

strStartsWith(s: <String>, prefix: <String>)
:: <Bool>
Аргумент Тип Описание Обязателен

s

String

Строка, префикс которой требуется проверить.

да

prefix

String

Префикс.

да

Пример

Исходный код
strStartsWith("Hello world", "Hello")
Результат
True

strEndsWith

Проверяет, заканчивается ли строка s суффиксом suffix.

Спецификация функции

strEndsWith(s: <String>, suffix: <String>)
:: <Bool>
Аргумент Тип Описание Обязателен

s

String

Строка, суффикс которой требуется проверить.

да

suffix

String

Суффикс.

да

Пример

Исходный код
strEndsWith("Hello world", "test")
Результат
False

strIncludes

Проверяет, содержит ли строка s подстроку part.

Спецификация функции

strIncludes(s: <String>, part: <String>)
:: <Bool>
Аргумент Тип Описание Обязателен

s

String

Строка, в которой требуется искать подстроку.

да

part

String

Подстрока.

да

Пример

Исходный код
strIncludes("Hello world", "wor")
Результат
True

strReverse

Разворачивает строку s.

Спецификация функции

strReverse(s: <String>)
:: <String>
Аргумент Тип Описание Обязателен

s

String

Строка, которую требуется развернуть.

да

Пример

Исходный код
strReverse("Hello")
Результат
olleH

Функции работы с датой и временем

dateNow

Возвращает текущую дату и время в формате как объект типа Date.

Спецификация функции

dateNow()
:: <Date>

Пример

Исходный код
dateNow()
Результат
20.10.2025 11:04:37

dateParse

Преобразует строку, число или дату s в объект типа Date.

Спецификация функции

dateParse(s: <String | Integer | Date>)
:: <Date>
Аргумент Тип Описание Обязателен

s

String Integer Date

Строка, число миллисекунд или дата, которую требуется преобразовать в дату и время.

да

Примеры

Преобразование строки в дату

Исходный код
dateParse("2025-09-30T10:31:41Z")
Результат
30.09.2025 13:31:41

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

Исходный код
dateParse(1759220238000)
Результат
30.09.2025 11:17:18

dateFormat

Преобразует объект типа Date в строку в формате, указанном в аргументе pattern.

Спецификация функции

dateParse(d: <Date>, [pattern: <String>])
:: <String>
Аргумент Тип Описание Обязателен

d

Date

Дата, которую требуется преобразовать в строку.

да

pattern

String

Строка формата.

Допустимые шаблоны в строке формата:

  • yyyy — год, например, 2025;

  • MM — месяц (01—​12);

  • dd — день (01—​31);

  • HH — часы (00—​23);

  • mm — минуты (00-59);

  • ss — секунды (00-59).

Значение по умолчанию — yyyy-MM-dd HH:mm:ss.

да

Примеры

Преобразование текущей даты в формат ISO 8601

Исходный код
dateFormat(dateNow(), "yyyy-MM-ddTHH:mm:ssZ")
Результат
2025-10-20T12:00:13Z

Извлечение даты из временной метки

Исходный код
dateFormat(dateNow(), "HH:mm:ss")
Результат
12:01:00

dateYear

Извлекает год из даты.

Спецификация функции

dateYear(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, из которой требуется извлечь год.

да

Пример

Исходный код
dateYear(dateParse("2025-12-31 23:58:59"))
Результат
2025

dateMonth

Извлекает месяц из даты.

Спецификация функции

dateMonth(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, из которой требуется извлечь месяц.

да

Пример

Исходный код
dateMonth(dateParse("2025-12-31 23:58:59"))
Результат
12

dateDay

Извлекает день из даты.

Спецификация функции

dateDay(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, из которой требуется извлечь день.

да

Пример

Исходный код
dateDay(dateParse("2025-12-31 23:58:59"))
Результат
31

dateHour

Извлекает час из даты.

Спецификация функции

dateHour(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, из которой требуется извлечь час.

да

Пример

Исходный код
dateHour(dateParse("2025-12-31 23:58:59"))
Результат
23

dateMinute

Извлекает минуту из даты.

Спецификация функции

dateMinute(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, из которой требуется извлечь минуту.

да

Пример

Исходный код
dateMinute(dateParse("2025-12-31 23:58:59"))
Результат
58

dateSecond

Извлекает секунды из даты.

Спецификация функции

dateSecond(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, из которой требуется извлечь секунды.

да

Пример

Исходный код
dateSecond(dateParse("2025-12-31 23:58:59"))
Результат
59

dateAddDays

Добавляет указанное количество дней к дате или вычитает, если указано отрицательное число.

Спецификация функции

dateAddDays(d: <Date>, n: <Integer>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется прибавить или вычесть дни.

да

n

Integer

Количество дней, которое требуется прибавить или вычесть. Положительное или отрицательное целое число.

да

Пример

Прибавление дней

Исходный код
dateAddDays(dateParse("2025-12-31 23:58:59"), 30)
Результат
30.01.2026 23:58:59

Вычитание дней

Исходный код
dateAddDays(dateParse("2025-12-31 23:58:59"), -10)
Результат
21.12.2026 23:58:59

dateAddMonths

Добавляет указанное количество месяцев к дате или вычитает, если указано отрицательное число.

Спецификация функции

dateAddMonths(d: <Date>, n: <Integer>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется прибавить или вычесть месяцы.

да

n

Integer

Количество месяцев, которое требуется прибавить или вычесть. Положительное или отрицательное целое число.

да

Примеры

Прибавление месяцев

Исходный код
dateAddMonths(dateParse("2025-12-31 23:58:59"), 3)
Результат
31.03.2026 23:58:59

Вычитание месяцев

Исходный код
dateAddMonths(dateParse("2025-12-31 23:58:59"), -2)
Результат
31.10.2025 23:58:59

dateAddYears

Добавляет указанное количество лет к дате или вычитает, если указано отрицательное число.

Спецификация функции

dateAddYears(d: <Date>, n: <Integer>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется прибавить или вычесть года.

да

n

Integer

Количество лет, которое требуется прибавить или вычесть. Положительное или отрицательное целое число.

да

Примеры

Прибавление лет

Исходный код
dateAddYears(dateParse("2025-12-31 23:58:59"), 3)
Результат
31.12.2028 23:58:59

Вычитание лет

Исходный код
dateAddYears(dateParse("2025-12-31 23:58:59"), -2)
Результат
31.12.2023 23:58:59

dateStartOfDay

Возвращает начало суток (00:00:00) указанной даты.

Спецификация функции

dateStartOfDay(d: <Date>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется получить начало суток.

да

Пример

Исходный код
dateStartOfDay(dateParse("2025-12-31 23:00:00"))
Результат
31.12.2025 00:00:00

dateEndOfDay

Возвращает конец суток (23:59:59) указанной даты.

Спецификация функции

dateEndOfDay(d: <Date>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется получить конец суток.

да

Пример

Исходный код
dateEndOfDay(dateParse("2025-12-31 23:00:00"))
Результат
31.12.2025 23:59:59

dateStartOfMonth

Возвращает начало месяца (первое число, 00:00:00) для указанной даты.

Спецификация функции

dateStartOfMonth(d: <Date>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется получить начало месяца.

да

Пример

Исходный код
dateStartOfMonth(dateParse("2025-12-31 23:00:00"))
Результат
01.12.2025 00:00:00

dateEndOfMonth

Возвращает конец месяца (последний день, 23:59:59) для указанной даты.

Спецификация функции

dateEndOfMonth(d: <Date>)
:: <Date>
Аргумент Тип Описание Обязателен

d

Date

Дата, для которой требуется получить конец месяца.

да

Пример

Исходный код
dateEndOfMonth(dateParse("2025-12-31 23:00:00"))
Результат
31.12.2025 23:59:59

dateDiff

Возвращает разницу между датами в указанных единицах (секундах, минутах, часах, днях).

Спецификация функции

dateDiff(d1: <Date>, d2: <Date>, [unit: <String>])
:: <Integer>
Аргумент Тип Описание Обязателен

d1

Date

Начальная дата.

да

d2

Date

Конечная дата.

да

unit

String

Единица измерения:

  • seconds — секунды;

  • minutes — минуты;

  • hours — часы;

  • days — дни.

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

нет

Пример

Исходный код
dateDiff(dateParse("2025-12-30 12:00:00"), dateParse("2026-01-01 00:00:00"), "hours")
Результат
36

dateIsBefore

Возвращает True, если дата d1 раньше d2, False иначе.

Спецификация функции

dateIsBefore(d1: <Date>, d2: <Date>)
:: <Bool>
Аргумент Тип Описание Обязателен

d1

Date

Первая дата.

да

d2

Date

Вторая дата.

да

Пример

Исходный код
dateIsBefore(dateParse("2025-12-30 12:00:00"), dateParse("2026-01-01 00:00:00"))
Результат
True

dateIsAfter

Возвращает True, если дата d1 позже d2, False иначе.

Спецификация функции

dateIsAfter(d1: <Date>, d2: <Date>)
:: <Bool>
Аргумент Тип Описание Обязателен

d1

Date

Первая дата.

да

d2

Date

Вторая дата.

да

Пример

Исходный код
dateIsAfter(dateParse("2025-12-30 12:00:00"), dateParse("2026-01-01 00:00:00"))
Результат
False

dateIsBetween

Возвращает True, если дата d находится между d1 и d2, включая обе границы диапазона, False иначе.

Спецификация функции

dateIsBetween(d: <Date>, d1: <Date>, d2: <Date>)
:: <Bool>
Аргумент Тип Описание Обязателен

d

Date

Дата, вхождение которой в диапазон требуется проверить.

да

d1

Date

Левая граница диапазона.

да

d2

Date

Правая граница диапазона.

да

Пример

Исходный код
dateIsBetween(dateParse("2025-12-30 18:00:00"), dateParse("2025-12-30 12:00:00"), dateParse("2026-01-01 00:00:00"))
Результат
True

dateToTimestamp

Возвращает Unix timestamp — количество секунд с начала эпохи Unix (1 января 1970 г., 00:00:00) до указанной даты.

Спецификация функции

dateToTimestamp(d: <Date>)
:: <Integer>
Аргумент Тип Описание Обязателен

d

Date

Дата, которую требуется преобразовать в Unix timestamp.

да

Пример

Исходный код
dateToTimestamp(dateParse("2025-12-30 19:00:00"))
Результат
1767121200

timestampToDate

Преобразует Unix timestamp в объект типа Date.

Спецификация функции

timestampToDate(t: <Integer>)
:: <Date>
Аргумент Тип Описание Обязателен

t

Integer

Количество секунд с начала эпохи Unix.

да

Пример

Исходный код
timestampToDate(1767121200)
Результат
30.12.2025 19:00:00

Функции для работы с логическими значениями

if

Если условие cond истинно, возвращает значение thenVal, иначе elseVal.

Спецификация функции

if(cond: <Bool>, thenVal: <any>, elseVal: <any>)
:: <any>
Аргумент Тип Описание Обязателен

cond

Bool

Логическое значение или выражение.

да

thenVal

любой тип

Значение, которое вернет функция, если cond истинно.

да

elseVal

любой тип

Значение, которое вернет функция, если cond ложно.

да

Пример

Исходный код
if({field:subjectCount} < 10000, "Да", "Нет")

xor

Исключающее ИЛИ для двух логических значений a и b.

Спецификация функции

xor(a: <Bool>, b: <Bool>)
:: <Bool>
Аргумент Тип Описание Обязателен

a

Bool

Левый операнд исключающего ИЛИ.

да

b

Bool

Правый операнд исключающего ИЛИ.

да

Пример

Исходный код
xor(True, False)
Результат
True

andAll

Возвращает True, если все элементы массива arr истинны, иначе False.

Спецификация функции

andAll(arr: <Array [Bool]>)
:: <Bool>
Аргумент Тип Описание Обязателен

arr

Array [Bool]

Массив логических значений или выражений.

да

Пример

Исходный код
andAll([True, 2 > 1, True])
Результат
True

orAny

Возвращает True, если хотя бы один элемент массива arr является истинным, иначе False.

Спецификация функции

orAny(arr: <Array [Bool]>)
:: <Bool>
Аргумент Тип Описание Обязателен

arr

Array [Bool]

Массив логических значений или выражений.

да

Пример

Исходный код
orAny([True, 2 < 1, False])
Результат
True

not

Логическое отрицание (инверсия).

Спецификация функции

not(a: <Bool>)
:: <Bool>
Аргумент Тип Описание Обязателен

a

Bool

Логическое значение или выражение.

да

Пример

Исходный код
not(2 < 1)
Результат
True

Функции для работы с коллекциями

countElements

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

Спецификация функции

countElements(args: <List>)
:: <Integer>
Аргумент Тип Описание Обязателен

args

List

Список элементов любого типа.

да

Пример

Исходный код
countElements(1, true, "test", "2025-09-30")
Результат
4

Была ли полезна эта страница?

+7 (499) 755 55 70 sales@rvision.ru

О компании Пользовательское соглашение Политика cookies

Обратная связь