Стандартные функции адаптивных выражений

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

В этой статье перечислены доступные стандартные функции с упорядочением по их назначению. Сведения о операторах, используемых в предварительно созданных функциях и синтаксисе выражений, см. в разделе "Операторы".

Предварительно созданные выражения разделены на приведенные ниже типы.

• String
• Коллекция
• Логическое сравнение
• Преобразование
• Math
• Дата
• Timex
• Синтаксический анализ URI
• Обработка и создание объектов
• Регулярное выражение
• Проверка типа

Этот же список можно просмотреть в алфавитном порядке.

Строковые функции

Function	Описание
length	Возвращает длину строки.
replace	Заменяет подстроку указанной строкой и возвращает обновленную строку. Эта функция учитывает регистр.
replaceIgnoreCase	Заменяет подстроку указанной строкой и возвращает обновленную строку. Эта функция не учитывает регистр.
split	Возвращает массив подстрок с разбиением по указанному разделителю.
substring	Возвращает символы из строки.
toLower	Возвращает строку в нижнем регистре в необязательном формате языкового стандарта.
toUpper	Возвращает строку в верхнем регистре в необязательном формате языкового стандарта.
trim	Удаляет пробелы в начале и конце строки.
addOrdinal	Возвращает порядковый номер полученного числа.
endsWith	Проверяет, заканчивается ли строка определенной подстрокой. Возвращает true, если подстрока найдена, или false в противном случае. Эта функция не учитывает регистр.
startsWith	Проверяет, начинается ли строка с определенной подстроки. Возвращает true, если подстрока найдена, или false в противном случае. Эта функция не учитывает регистр.
countWord	Возвращает количество слов в полученной строке.
concat	Объединяет две или более строк и возвращает объединенную строку.
newGuid	Возвращает строку с новым GUID.
indexOf	Возвращает начальную позицию или значение индекса указанной подстроки или находит указанный объект и возвращает индекс его первого вхождения в коллекцию (отсчет начинается с нуля). Эта функция не учитывает регистр, а значения индексов начинаются с 0.
lastIndexOf	Возвращает начальную позицию или значение индекса последнего вхождения подстроки или находит указанный объект и возвращает индекс его последнего вхождения в диапазоне элементов в списке (отсчет начинается с нуля). Эта функция не учитывает регистр, а значения индексов начинаются с 0.
предложениеCase	Заглавная буква первого слова в строке в необязательном локальном формате.
titleCase	Заглавная буква каждого слова в строке в необязательном формате языкового стандарта.
reverse	Измените порядок элементов в строке или массиве.

Функции сбора

Function	Описание
contains	Пытается найти элемент в строке, элемент в массиве или параметр в составном объекте. Примеры: contains('hello world', 'hello') contains(createArray('1','2'), '1') contains(json("{'foo':'bar'}"), 'foo')
first	Возвращает первый элемент коллекции.
join	Возвращает строку, содержащую все элементы из массива, в которой каждый символ отделен разделителем. Пример: join(createArray('a', 'b'), '.' = "a.b"
last	Возвращает последний элемент коллекции.
count	Возвращает количество элементов в коллекции.
foreach	Обрабатывает каждый элемент и возвращают новую коллекцию.
union	Возвращает коллекцию, которая содержит все элементы из указанных коллекций.
skip	Удаляет элементы из начала коллекции и возвращает оставшиеся элементы.
take	Возвращает элементы, расположенные в начале коллекции.
intersection	Возвращает коллекцию, которая содержит только общие элементы в указанных коллекциях.
subArray	Возвращает подмассив, полученный по указанным начальной и конечной позициям. Значения индекса начинаются с числа 0.
select	Обрабатывает каждый элемент и возвращают новую коллекцию преобразованных элементов.
where	Применяет фильтр к каждому элементу и возвращает новую коллекцию тех элементов, которые соответствуют указанному условию.
sortBy	Сортирует элементы коллекции по возрастанию и возвращает упорядоченную коллекцию.
sortByDescending	Сортирует элементы коллекции по убыванию и возвращает упорядоченную коллекцию.
indicesAndValues	Преобразует массив или объект в массив объектов, состоящих из индексов и значений.
flatten	Преобразует массивы в плоские структуры, у которых значения не являются массивами.
unique	Удаляет из массива все дубликаты.
любой	Определяет, соответствуют ли любые элементы последовательности условию.
all	Определите, соответствуют ли все элементы последовательности условию.
reverse	Измените порядок элементов в строке или массиве.
merge	Объединяет несколько объектов JSON или элементов в массиве.

Функции логического сравнения

Function	Описание
and	Логическое "И". Возвращает значение true, если все указанные выражения имеют значение true.
equals	Сравнение по строгому равенству. Возвращает значение true, если указанные значения равны.
empty	Проверяет, пуст ли целевой объект.
greater	Сравнение "больше чем". Возвращает значение true, если первое значение больше второго, или false в противном случае.
greaterOrEquals	Сравнение "больше или равно". Возвращает true, если первое значение больше второго или равно ему, или false в противном случае.
if	Проверьте, какое значение имеет выражение: true или false. Возвращает указанное значение на основе результата.
less	Сравнение меньше операции. Возвращает true, если первое значение меньше второго, или false в противном случае.
lessOrEquals	Оператор сравнения "меньше или равно". Возвращает true, если первое значение меньше второго или равно ему, или false в противном случае.
не	Логический не оператор. Возвращает true, если выражение ложно, или false в противном случае.
or	Логическая или операция. Возвращает значение true, если хотя бы одно выражение истинно, или false, если все являются ложными.
exists	Проверяет истинность выражения.

Функции преобразования

Function	Описание
float	Возвращает представление с плавающей запятой указанной строки.
int	Возвращает целое представление указанной строки.
string	Возвращает строковую версию указанного значения в необязательном формате языкового стандарта.
bool	Возвращает указанное значение в логическом формате.
createArray	Возвращает массив, полученный на основе нескольких входных данных.
json	Возвращает значение с типом JSON (нотация объектов JavaScript), объект с типом строки или XML.
base64	Возвращает строку или массив байтов в кодировке base64.
base64ToBinary	Возвращает двоичную версию строки с кодировкой base64.
base64ToString	Преобразует строку в кодировке base64 в строковый формат.
binary	Возвращает двоичную версию входного значения.
dataUri	Возвращает URI для входного значения.
dataUriToBinary	Возвращает URI данных в двоичном формате.
dataUriToString	Возвращает URI данных в строковом формате.
uriComponent	Возвращает кодированную версию URI для входного значения, заменив символы, опасные для URL-адреса, на escape-символы.
uriComponentToString	Преобразует строку в формате URI в строковый формат.
xml	Возвращает строку в формате XML.
formatNumber	Отформатируйте значение до ближайшего числа до указанного числа дробных цифр и дополнительного языкового стандарта.
jsonStringify	Возвращает строку JSON значения.
Интерполяция строки stringOrValue Wrap для получения реального значения. Например, stringOrValue('${1}') возвращает число 1, в то время как stringOrValue('${1} item') возвращает строку "1 элемент".

Математические функции

Function	Описание
abs	Возвращает абсолютное значение указанного числа.
добавление	Математическое сложение. Возвращает результат из добавления двух чисел (чистого регистра чисел) или объединения двух или более строк.
div	Математическое деление. Возвращает целочисленный результат деления двух чисел.
max	Возвращает наибольшее значение из коллекции.
min	Возвращает наименьший элемент коллекции.
mod (модуль)	Возвращает остаток результата деления двух чисел.
mul	Математическое умножение. Возвращает результат умножения двух чисел.
rand	Возвращает случайное число в диапазоне между указанными минимальным и максимальным значениями.
sqrt	Возвращает квадратный корень указанного числа.
sub	Математическое вычитание. Вычитает второе число из первого числа и возвращает результат.
sum	Возвращает сумму чисел в массиве.
range	Возвращает массив целых чисел, который начинается с заданного целого числа.
exp	Возвращает результат возведения указанного числа в указанную степень.
average	Возвращает среднее значение чисел в числовом массиве.
floor	Возвращает наибольшее целочисленное значение меньше или равно указанному числу.
ceiling	Возвращает наименьшее целочисленное значение, превышающее указанное число или равное ей.
round	Округление значения до ближайшего целого числа или указанного числа дробных цифр.

Функции даты и времени

Function	Описание
addDays	Добавьте число указанных дней к заданной метке времени в необязательном формате языкового стандарта.
addHours	Добавьте указанное количество часов в заданный метку времени в необязательном формате языкового стандарта.
addMinutes	Добавьте указанное количество минут к заданной метке времени в необязательном формате языкового стандарта.
addSeconds	Добавляет указанное количество секунд к указанной метке времени.
dayOfMonth	Возвращает день месяца для указанной метки времени или выражения Timex.
dayOfWeek	Возвращает день недели для указанной метки времени.
dayOfYear	Возвращает порядковый номер дня в году для указанной метки времени.
formatDateTime	Возвращает метку времени в необязательном формате языкового стандарта.
formatEpoch	Возвращает метку времени в необязательном формате языкового стандарта из времени эпохи UNIX (время Unix, время POSIX).
formatTicks	Возвращает метку времени в необязательном формате языкового стандарта из галок.
subtractFromTime	Вычитайте количество единиц времени из метки времени в необязательном формате языкового стандарта.
utcNow	Возвращает текущую метку времени в необязательном формате языкового стандарта в виде строки.
dateReadBack	Обратное чтение даты с помощью библиотеки date-time.
month	Возвращает месяц для указанной метки времени.
date	Возвращает дату для указанной метки времени.
year	Возвращает год для указанной метки времени.
getTimeOfDay	Возвращает время дня для указанной метки времени.
getFutureTime	Возвращает текущую метку времени в необязательном формате языкового стандарта и указанные единицы времени.
getPastTime	Возвращает текущую метку времени в необязательном формате языкового стандарта минус указанные единицы времени.
addToTime	Добавьте несколько единиц времени в метку времени в необязательном формате языкового стандарта.
convertFromUTC	Преобразуйте метку времени в необязательном формате языкового стандарта из универсального координированного времени (UTC).
convertToUTC	Преобразуйте метку времени в необязательном формате языкового стандарта в универсальный код времени (UTC).
startOfDay	Возвращает начало дня для метки времени в необязательном формате языкового стандарта.
startOfHour	Возвращает начало часа метки времени в необязательном формате языкового стандарта.
startOfMonth	Возвращает начало месяца для метки времени в необязательном формате языкового стандарта.
ticks	Возвращает значение свойства количества тактов для указанной метки времени.
ticksToDays	Преобразуйте значение свойства тиков в число дней.
ticksToHours	Преобразуйте значение свойства тиков в количество часов.
ticksToMinutes	Преобразуйте значение свойства тиков в количество минут.
dateTimeDiff	Возвращает разницу между двумя метками времени.
getPreviousViableDate	Возвращает предыдущую жизнеспособную дату выражения Timex на основе текущей даты и дополнительно указанного часового пояса.
getNextViableDate	Возвращает следующую жизнеспособную дату выражения Timex на основе текущей даты и дополнительно указанного часового пояса.
getPreviousViableTime	Возвращает предыдущее жизнеспособное время выражения Timex на основе текущего времени и дополнительно указанного часового пояса.
getNextViableTime	Возвращает следующее жизнеспособное время выражения Timex на основе текущего времени и дополнительно указанного часового пояса.

Функции Timex

Function	Описание
isPresent	Возвращает значение true, если выражение TimexProperty или Timex указывает текущее время.
isDuration	Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на длительность времени.
isTime	Возвращает значение true, если объект TimexProperty или выражение Timex указывает на конкретное время.
isDate	Возвращает значение true, если объект TimexProperty или выражение Timex указывает на конкретную дату.
isTimeRange	Возвращает значение true, если объект TimexProperty или выражение Timex указывает на диапазон времени.
isDateRange	Возвращает значение true, если объект TimexProperty или выражение Timex указывает на диапазон дат.
isDefinite	Возвращает значение true, если объект TimexProperty или выражение Timex указывает на определенный день.
решать	Возвращает строку заданного выражения TimexProperty или Timex, если он ссылается на допустимое время. Допустимое время содержит часы, минуты и секунды.

Функции анализа URI

Function	Описание
uriHost	Возвращает значение узла из исходного значения универсального кода ресурса (URI).
uriPath	Возвращает значение пути универсального идентификатора ресурса (URI).
uriPathAndQuery	Возвращает значения пути и запроса из исходного значения URI.
uriPort	Возвращает значение порта из исходного значения URI.
uriQuery	Retur0sn значение запроса универсального идентификатора ресурса (URI).
uriScheme	Возвращает значение схемы из исходного значения URI.

Функции обработки и создания объектов

Function	Описание
addProperty	Добавляет свойство и значение или пару "имя-значение" в объект JSON и возвращает обновленный объект.
removeProperty	Удаляет свойство из объекта JSON и возвращает обновленный объект.
setProperty	Задает новое значение для свойства в объекте JSON и возвращает обновленный объект.
getProperty	Возвращает значение указанного свойства или корневого свойства из объекта JSON.
coalesce	Возвращает первое ненулевое значение из одного или нескольких параметров.
xPath	Проверяет XML на наличие узлов или значений, которые соответствуют выражению XPath, и возвращает соответствующие узлы или значения.
jPath	В указанном объекте или строке JSON проверяет наличие узлов или значений, которые соответствуют выражению пути, и возвращает найденные узлы.
setPathToValue	Задает значение конкретного пути и возвращает это значение.

Функции регулярных выражений

Function	Описание
isMatch	Возвращает значение true, если строка соответствует общему шаблону регулярного выражения.

Функции проверки типа

Function	Описание
EOL	Возвращает текст последовательности строки (EOL).
isInteger	Возвращает значение true, если входное значение является целым числом.
isFloat	Возвращает значение true, если входное значение является числом с плавающей запятой.
isBoolean	Возвращает значение true, если входное значение является логическим значением.
isArray	Возвращает значение true, если входное значение является массивом.
isObject	Возвращает значение true, если входное значение является объектом.
isDateTime	Возвращает значение true, если входное значение является меткой времени в формате UTC ISO.
isString	Возвращает значение true , если заданные входные данные являются строкой.

Предварительно созданные функции отсортированы по алфавиту

abs

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

abs(<number>)

Параметр	Обязательное поле	Type	Описание
<number>	Да	number	Число для получения абсолютного значения

Возвращаемое значение	Тип	Description
<result>	number	Результат вычисления абсолютного значения.

Примеры

В этих примерах вычисляется абсолютное значение:

abs(3.12134)
abs(-3.12134)

И оба возвращают результат 3.12134.

add

Возвращает результат добавления двух или более чисел (чистого регистра чисел) или объединения двух или более строк (другого регистра).

add(<item1>, <item2>, ...)

Параметр	Обязательное поле	Type	Описание
<item1>, <item2>,...	Да	любое	items

Возвращаемое значение	Тип	Описание
<итоговая_сумма>	число или строка	Результат сложения указанных чисел или результат объединения.

Пример

В этом примере добавляются указанные числа:

add(1, 1.5)

И возвращается результат 2,5.

В этом примере объединяются указанные элементы:

add('hello',null)
add('hello','world')

И возвращает результаты.

• hello
• helloworld

addDays

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

addDays('<timestamp>', <days>, '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка с меткой времени в стандартном формате UTC ISO: YYYY-MM-DDTHH:mm:ss.fffZ
<days>	Да	integer	Положительное или отрицательное число дней для добавления
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Метка времени и указанное число дней

Пример 1

В этом примере до указанной метки времени добавляется 10 дней:

addDays('2018-03-15T13:00:00.000Z', 10)

И возвращается результат 2018-03-25T00:00:00.000Z.

Пример 2

В этом примере от указанной метки времени отнимается пять дней:

addDays('2018-03-15T00:00:00.000Z', -5)

И возвращается результат 2018-03-10T00:00:00.000Z.

Пример 3

В этом примере добавляется 1 день к указанной метке времени в языковом стандарте de-DE :

addDays('2018-03-15T13:00:00.000Z', 1, '', 'de-dE')

И возвращает результат 16.03.18 13:00:00.

addHours

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

addHours('<timestamp>', <hours>, '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<hour>s	Да	integer	Положительное или отрицательное число часов для добавления
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Метка времени и указанное число часов

Пример 1

В этом примере до указанной метки времени добавляется 10 часов:

addHours('2018-03-15T00:00:00.000Z', 10)

И возвращается результат 2018-03-15T10:00:00.000Z.

Пример 2

В этом примере от указанной метки времени отнимается пять часов:

addHours('2018-03-15T15:00:00.000Z', -5)

И возвращается результат 2018-03-15T10:00:00.000Z.

Пример 3

В этом примере добавляется 2 часа к указанной метке времени в языковом стандарте de-DE :

addHours('2018-03-15T13:00:00.000Z', 2, '', 'de-DE')

И возвращает результат 15.03.18 15:00:00.

addMinutes

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

addMinutes('<timestamp>', <minutes>, '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<minutes>	Да	integer	Положительное или отрицательное число минут для добавления
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Метка времени и указанное число минут

Пример 1

В этом примере до указанной метки времени добавляется 10 минут:

addMinutes('2018-03-15T00:10:00.000Z', 10)

И возвращается результат 2018-03-15T00:20:00.000Z.

Пример 2

В этом примере от указанной метки времени отнимается пять минут:

addMinutes('2018-03-15T00:20:00.000Z', -5)

И возвращается результат 2018-03-15T00:15:00.000Z.

Пример 3

В этом примере добавляется 30 минут к указанной метке времени в языковом стандарте de-DE :

addMinutes('2018-03-15T00:00:00.000Z', 30, '', 'de-DE')

И возвращает результат 15.03.18 13:30:00.

addOrdinal

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

addOrdinal(<number>)

Параметр	Обязательное поле	Type	Описание
<number>	Да	integer	Числовые значения для преобразования в порядковый номер.

Возвращаемое значение	Тип	Description
<result>	строка	Порядковый номер, полученный из исходного числа.

Пример

addOrdinal(11)
addOrdinal(12)
addOrdinal(13)
addOrdinal(21)
addOrdinal(22)
addOrdinal(23)

И возвращаются следующие результаты.

• 11th
• 12th
• 13th
• 21st
• 22nd
• 23rd

addProperty

Добавляет свойство и его значения или пару "имя — значение" в объект JSON и возвращает обновленный объект. Если объект уже существует во время выполнения, функция выдает ошибку.

addProperty('<object>', '<property>', value)

Параметр	Обязательное поле	Type	Описание
<object>	Да	объект	Объект JSON, в который вы хотите добавить свойство
<свойство>	Да	строка	Имя добавляемого свойства.
<значение>	Да	любое	Значение свойства

Возвращаемое значение	Тип	Описание
<обновленный_объект>	объект	Обновленный объект JSON, полученный после добавления свойства.

Пример

В этом примере свойство accountNumber добавляется в объект customerProfile, который затем преобразуется в JSON с помощью функции json(). Эта функция присваивает значение, созданное функцией newGuid(), и возвращает обновленный объект.

addProperty(json('customerProfile'), 'accountNumber', newGuid())

addSeconds

Добавляет количество секунд к метке времени.

addSeconds('<timestamp>', <seconds>, '<format>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<seconds>	Да	integer	Положительное или отрицательное число секунд для добавления
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Метка времени и указанное число секунд

Пример 1

В этом примере к указанной метке времени добавляется 10 секунд:

addSeconds('2018-03-15T00:00:00.000Z', 10)

И возвращается результат 2018-03-15T00:00:10.000Z.

Пример 2

В этом примере от указанной метки времени отнимается пять секунд:

addSeconds('2018-03-15T00:00:30.000Z', -5)

И возвращается результат 2018-03-15T00:00:25.000Z.

addToTime

Добавьте несколько единиц времени в метку времени в необязательном формате языкового стандарта. См. раздел getFutureTime().

addToTime('<timestamp>', '<interval>', <timeUnit>, '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<interval>	Да	integer	Число единиц времени для добавления
<timeUnit>	Да	строка	Единица измерения времени, которая будет применяться к значению interval: Поддерживаются следующие единицы: Second (секунда), Minute (минута), Hour (час), Day (день), Week (неделя), Month (месяц) и Year (год).
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Метка времени с добавлением числа указанных единиц времени в определенном формате.

Пример 1

В этом примере к указанной метке времени добавляется один день.

addToTime('2018-01-01T00:00:00.000Z', 1, 'Day')

И возвращается результат 2018-01-02T00:00:00.000Z.

Пример 2

В этом примере к указанной метке времени добавляются две недели.

addToTime('2018-01-01T00:00:00.000Z', 2, 'Week', 'MM-DD-YY')

И возвращается результат в формате MM-DD-YY: 01-15-18.

all

Определите, соответствуют ли все элементы последовательности условию.

all(<sequence>, <item>, <condition>)

Параметр	Обязательное поле	Type	Описание
<последовательность>	Да	объект	Последовательность для вычисления.
<item>	Да	строка	Ссылается на элементы, которые будут оцениваться в последовательности.
<условие>	Да	выражение	Выражение для вычисления условия.

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращается true , если все элементы удовлетворяют условию. Возвращается false , если это не так.

Примеры

В этих примерах определяется, соответствуют ли все элементы последовательности условию:

all(createArray(1, 'cool'), item, isInteger(item))
all(createArray(1, 2), item => isInteger(item))

И возвращаются следующие результаты соответственно:

• False, так как оба элемента в последовательности не являются целыми числами.
• True, так как оба элемента в последовательности являются целыми числами.

и

Проверяет, истинны ли все выражения. Возвращает значение true, если все выражения истинны, или false, если хотя бы одно выражение ложно.

and(<expression1>, <expression2>, ...)

Параметр	Обязательное поле	Type	Описание
<expression1>, <expression2>, ...	Да	Логический	Выражения, которые следует проверить

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает значение true, если все выражения истинны. Возвращает значение false, если хотя бы одно выражение ложно.

Пример 1

В этих примерах проверяется, все ли указанные логические значения верны:

and(true, true)
and(false, true)
and(false, false)

И возвращаются следующие результаты.

• оба выражения имеют значения true, поэтому функция возвращает true;
• одно выражение имеет значение false, поэтому функция возвращает false;
• оба выражения имеют значения false, поэтому функция возвращает false.

Пример 2

В этих примерах проверяется, все ли указанные выражения верны:

and(equals(1, 1), equals(2, 2))
and(equals(1, 1), equals(1, 2))
and(equals(1, 2), equals(1, 3))

И возвращаются следующие результаты.

• оба выражения имеют значения true, поэтому функция возвращает true;
• одно выражение имеет значение false, поэтому функция возвращает false;
• оба выражения имеют значения false, поэтому функция возвращает false.

любое

Определите, соответствуют ли какие-либо элементы последовательности условию.

all(<sequence>, <item>, <condition>)

Параметр	Обязательное поле	Type	Описание
<последовательность>	Да	объект	Последовательность для вычисления.
<item>	Да	строка	Ссылается на элементы, которые будут оцениваться в последовательности.
<условие>	Да	выражение	Выражение для вычисления условия.

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращается true , если все элементы удовлетворяют условию. Возвращается false , если это не так.

Примеры

В этих примерах определяется, соответствуют ли все элементы последовательности условию:

any(createArray(1, 'cool'), item, isInteger(item))
any(createArray('first', 'cool'), item => isInteger(item))

И возвращаются следующие результаты соответственно:

• True, так как по крайней мере один элемент в последовательности является целым числом.
• false, так как ни один элемент в последовательности не является целым числом.

average

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

average(<numericArray>)

Параметр	Обязательное поле	Type	Описание
<numericArray>	Да	массив чисел	Входной массив для вычисления среднего арифметического.

Возвращаемое значение	Тип	Описание
<average-of-array>	number	Среднее арифметическое значение по указанному массиву.

Пример

В этом примере вычисляется среднее по массиву createArray().

average(createArray(1,2,3))

И возвращается результат 2.

base64

Возвращает строку или массив байтов в кодировке base64.

base64('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	Строка или байтовый массив	Строка входных данных

Возвращаемое значение	Тип	Описание
<строка_base64>	строка	Исходная строка в формате строки с кодировкой base64.

Пример 1

В этом примере строка hello преобразуется в строку с кодировкой base64.

base64('hello')

И возвращается результат "aGVsbG8=".

Пример 2

В этом примере принимается byteArrnew byte[] { 3, 5, 1, 12 }значение, равное:

base64('byteArr')

И возвращается результат "AwUBDA==".

base64ToBinary

Возвращает строку с кодировкой base64 в формате двоичного массива.

base64ToBinary('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Преобразуемая строка с кодировкой base64

Возвращаемое значение	Тип	Описание
<двоичная версия для строки base64>	массив байтов;	Версия строки с кодировкой base64 в двоичном формате.

Пример

В этом примере строка AwUBDA== с кодировкой base64 преобразуется в двоичную строку:

base64ToBinary('AwUBDA==')

И возвращается результат new byte[] { 3, 5, 1, 12 }.

base64ToString

Возвращает строковое значение, полученное из строки с кодировкой base64, что по сути означает расшифровку строки base64.

base64ToString('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Декодируемая строка с кодировкой base64.

Возвращаемое значение	Тип	Описание
<декодированная строка base64>	строка	Строковая версия, полученная из строки с кодировкой base64.

Пример

В этом примере строка aGVsbG8= в кодировке base64 преобразуется в расшифрованную строку.

base64ToString('aGVsbG8=')

И возвращается результат hello.

binary

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

binary('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Преобразуемая строка

Возвращаемое значение	Тип	Описание
<двоичная форма входного значения>	массив байтов;	Двоичная строка, полученная из указанной строки.

Пример

В этом примере строка hello преобразуется в двоичную строку.

binary('hello')

И возвращается результат new byte[] { 104, 101, 108, 108, 111 }.

bool

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

bool(<value>)

Параметр	Обязательное поле	Type	Описание
<значение>	Да	любое	Значение, которое необходимо преобразовать

Возвращаемое значение	Тип	Описание
true или false	Логический	Указанное значение в логическом формате.

Пример

В этих примерах указанные значения преобразуются в логические:

bool(1)
bool(0)

И возвращаются следующие результаты.

• true
• false

ceiling

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

ceiling('<number>')

Параметр	Обязательное поле	Type	Описание
<number>	Да	number	Входной номер

Возвращаемое значение	Тип	Описание
<целочисленное значение>	integer	Наибольшее целочисленное значение больше или равно входной цифре

Пример

В этом примере возвращается наибольшее целочисленное значение меньше или равно числу 10,333:

ceiling(10.333)

И возвращает целое число 11.

coalesce

Возвращает первое ненулевое значение из одного или нескольких параметров. Пустые строки, пустые массивы и пустые объекты не имеют значение null.

coalesce(<object**1>, <object**2>, ...)

Параметр	Обязательное поле	Type	Описание
<object**1>, <object**2>, ...	Да	Любой (допустимы смешанные типы)	Один или несколько элементов для проверки на наличие значения NULL

Возвращаемое значение	Тип	Описание
<первый не нулевой элемент>	любое	Первый элемент или значение, которое не равно NULL. Если все параметры равны NULL, эта функция возвращает значение NULL.

Пример

Эти примеры возвращают первое значение, не равное NULL, из указанных значений или равное NULL, когда все значения равны NULL:

coalesce(null, true, false)
coalesce(null, 'hello', 'world')
coalesce(null, null, null)

И соответственно возвращается:

• true
• hello
• null

concat

Объедините два или более объектов и верните объединенные объекты в списке или строке.

concat('<text1>', '<text2>', ...)

Параметр	Обязательное поле	Type	Описание
<object1>, <object2>, ...	Да	любое	По крайней мере два объекта для объединения.

Возвращаемое значение	Тип	Описание
<object1object2...>	строка или список	Объединенная строка или список. Значения NULL пропускаются.

Ожидаемые возвращаемые значения:

• Если все элементы являются списками, возвращается список.
• Если существует элемент, который не является списком, возвращается строка.
• Если значение равно NULL, оно пропускается и не объединяется.

Пример

В этом примере объединяются строки Hello и World.

concat('Hello', 'World')

И возвращается результат HelloWorld.

Пример 2

В этом примере объединяются списки [1,2] и [3,4]:

concat([1,2],[3,4])

И возвращает результат [1,2,3,4].

Пример 3

В этих примерах объединяются объекты разных типов:

concat('a', 'b', 1, 2)
concat('a', [1,2])

И возвращаются следующие результаты соответственно:

• Строка ab12.
• Объект aSystem.Collections.Generic.List 1[System.Object]. Это нечитаемо и лучше всего избежать.

Пример 4

Эти примеры объединяют объекты:null

concat([1,2], null)
concat('a', 1, null)

И возвращаются следующие результаты соответственно:

• Список [1,2].
• Строка a1.

содержит

Проверяет наличие определенного элемента в коллекции. Возвращает true, если элемент найден, или false в противном случае. Эта функция учитывает регистр.

contains('<collection>', '<value>')
contains([<collection>], '<value>')

Эта функция работает с такими типами коллекций:

• строка, в которой ищется подстрока;
• массив, в котором ищется значение;
• словарь, в котором ищется ключ.

Параметр	Обязательное поле	Type	Описание
<collection>	Да	Строка, массив или словарь.	Коллекция для проверки
<значение>	Да	Строка, массив или словарь соответственно.	Искомый элемент

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает true, если элемент найден. Возвращает false, если не найден.

Пример 1

В этом примере строка hello world проверяется на наличие подстроки world.

contains('hello world', 'world')

И возвращается результат true.

Пример 2

В этом примере строка hello world проверяется на наличие подстроки universe.

contains('hello world', 'universe')

И возвращается результат false.

count

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

count('<collection>')
count([<collection>])

Параметр	Обязательное поле	Type	Описание
<collection>	Да	строка или массив	Коллекция с элементами для подсчета

Возвращаемое значение	Тип	Описание
<длина или число>	integer	Число элементов в данной коллекции

Примеры:

В этих примерах подсчитывается количество элементов в этих коллекциях:

count('abcd')
count(createArray(0, 1, 2, 3))

И в обоих возвращается результат 4.

countWord

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

countWord('<text>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка для подсчета слов.

Возвращаемое значение	Тип	Описание
<count>	integer	Количество слов в исходной строке.

Пример

В этом примере подсчитывается количество слов в строке hello world.

countWord("hello word")

И возвращается результат 2.

convertFromUTC

Преобразуйте метку времени в необязательном формате языкового стандарта из универсального координированного времени (UTC) в целевой часовой пояс.

convertFromUTC('<timestamp>', '<destinationTimeZone>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<destinationTimeZone>	Да	строка	Имя целевого часового пояса. Поддерживает часовые пояса Windows и IANA.
<format>	Нет	строка	Пользовательский шаблон формата. Формат метки времени по умолчанию — это формат O, y-MM-ddTHH:mm:ss.fffK, соответствующий ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<преобразованная метка времени>	строка	Метка времени, преобразованная в целевой часовой пояс

Примеры:

В этом примере время в формате UTC преобразовывается в Тихоокеанское время США.

convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time', 'MM-DD-YY')
convertFromUTC('2018-02-02T02:00:00.000Z', 'Pacific Standard Time')

И возвращаются следующие результаты:

• 02-01-18
• 2018-01-01T18:00:00.0000000

Пример 2

В этом примере преобразуется метка времени в языковом стандарте en-US из UTC в тихоокеанское стандартное время:

convertFromUTC('2018-01-02T02:00:00.000Z', 'Pacific Standard Time', 'D', 'en-US')

И возвращает результат понедельник, 1 января 2018 года.

convertToUTC

Преобразуйте метку времени в необязательном формате языкового стандарта в универсальный код времени (UTC) из исходного часового пояса.

convertToUTC('<timestamp>', '<sourceTimeZone>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<sourceTimeZone>	Да	строка	Имя целевого часового пояса. Поддерживает часовые пояса Windows и IANA.
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<преобразованная метка времени>	строка	Метка времени, преобразованная в целевой часовой пояс

Пример

В этом примере метка времени преобразуется в формате UTC из Тихоокеанского стандартного времени

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time')

И возвращает результат 2018-01-01T08:00:00.000Z.

Пример 2

В этом примере преобразуется метка времени в языковом стандарте de-DE в формате UTC из Тихоокеанского стандартного времени:

convertToUTC('01/01/2018 00:00:00', 'Pacific Standard Time', '', 'de-DE')

И возвращает результат 01.01.18 08:00:00.

createArray

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

createArray('<object1>', '<object2>', ...)

Параметр	Обязательное поле	Type	Описание
<object1>, <object2>, ...	Да	Любой, но не смешанный.	По крайней мере два элемента для создания массива

Возвращаемое значение	Тип	Описание
[<object1>, <object2>, ...]	array	Массив, созданный из всех входных элементов

Пример

В этом примере создается массив из следующих входных элементов:

createArray('h', 'e', 'l', 'l', 'o')

И возвращается результат [h ,e, l, l, o].

dataUri

Возвращает URI данных для строки.

dataUri('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Преобразуемая строка

Возвращаемое значение	Тип	Описание
[<date-uri>]	строка	URI данных для входной строки

Пример

dataUri('hello')

Возвращается результат data:text/plain;charset=utf-8;base64,aGVsbG8=.

dataUriToBinary

Возвращает URI данных в двоичном формате.

dataUriToBinary('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	URI данных для преобразования

Возвращаемое значение	Тип	Описание
[<binary-for-data-uri>]	массив байтов;	URI данных в двоичном формате.

Пример

В этом примере создается двоичная версия следующего URI данных.

dataUriToBinary('aGVsbG8=')

И возвращается результат new byte[] { 97, 71, 86, 115, 98, 71, 56, 61 }.

dataUriToString

Возвращает URI данных в строковом формате.

dataUriToString('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	URI данных для преобразования

Возвращаемое значение	Тип	Описание
[<string-for-data-uri>]	строка	Строковая версия URI данных.

Пример

В этом примере создается строковое значение на основе следующего URI данных.

dataUriToString('data:text/plain;charset=utf-8;base64,aGVsbG8=')

И возвращается результат hello.

Дата

Возвращает значение указанной метки времени в формате m/dd/yyyy.

date('<timestramp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени

Возвращаемое значение	Тип	Описание
<d>ate	строка	Дата из указанной метки времени.

date('2018-03-15T13:00:00.000Z')

И возвращается результат 3-15-2018.

dateReadBack

Обратное чтение даты с помощью библиотеки date-time.

dateReadBack('<currentDate>', '<targetDate>')

Параметр	Обязательное поле	Type	Описание
<currentDate>	Да	строка	Строка, содержащая текущую дату.
<targetDate>	Да	строка	Строка, содержащая целевую дату.

Возвращаемое значение	Тип	Описание
<date-readback>	строка	Обратное чтение значений от текущей даты до целевой даты.

Пример 1

dateReadBack('2018-03-15T13:00:00.000Z', '2018-03-16T13:00:00.000Z')

Возвращается значение tomorrow (завтра).

dateTimeDiff

Возвращает разницу между двумя метками времени.

dateTimeDiff('<timestamp1>', '<timestamp2>')

Параметр	Обязательное поле	Type	Описание
<метка времени1>	Да	строка	Первая строка метки времени для сравнения
<метка времени2>	Да	строка	Вторая строка метки времени для сравнения

Возвращаемое значение	Тип	Описание
<ticks>	number	Разница между двумя метками времени

Пример 1

В этом примере возвращается разница между двумя метками времени:

dateTimeDiff('2019-01-01T08:00:00.000Z','2018-01-01T08:00:00.000Z')

И возвращает номер 31536000000000000000000.

Пример 2

В этом примере возвращается разница между двумя метками времени:

dateTimeDiff('2018-01-01T08:00:00.000Z', '2019-01-01T08:00:00.000Z')

Возвращает результат -31536000000000000000000. Это значение является отрицательным числом.

dayOfMonth

Возвращает день месяца из метки времени.

dayOfMonth('<timestamp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени

Возвращаемое значение	Тип	Описание
<день месяца>	integer	День месяца из указанной метки времени

Пример

В этом примере возвращается число дня месяца из следующей метки времени.

dayOfMonth('2018-03-15T13:27:36Z')

И возвращается результат 15.

dayOfWeek

Возвращает день недели из метки времени.

dayOfWeek('<timestamp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени

Возвращаемое значение	Тип	Описание
<день недели>	integer	День недели из указанной метки времени. Здесь 0 обозначает воскресенье, 1 — понедельник и т. д.

Пример

В этом примере возвращается номер дня недели из следующей метки времени.

dayOfWeek('2018-03-15T13:27:36Z')

И возвращается результат 3.

dayOfYear

Возвращает день года из метки времени.

dayOfYear('<timestamp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени

Возвращаемое значение	Тип	Описание
<день года>	integer	День года из указанной метки времени

Пример

В этом примере возвращается порядковый номер дня в году из следующей метки времени.

dayOfYear('2018-03-15T13:27:36Z')

И возвращается результат 74.

div

Возвращает целочисленный результат деления двух чисел. Чтобы получить остаток, см. инструкции в разделе mod().

div(<dividend>, <divisor>)

Параметр	Обязательное поле	Type	Описание
<dividend>	Да	number	Число, которое нужно поделить на делитель
<divisor>	Да	number	Число, на которое делится делимое. Не может быть равен 0.

Возвращаемое значение	Тип	Описание
<результат деления>	number	Результат от деления первого числа на второе.

Пример

В обоих примерах первое число делится на второе:

div(10, 5)
div(11, 5)

И возвращается результат 2.

Существует некоторый разрыв между javascript и пакетом SDK для .NET. Например, следующее выражение возвращает различные результаты в пакете SDK javascript и .NET:

Если один из параметров является плавающей, результат также будет float с пакетом SDK для .NET.

Пример

div(11.2, 2)

Возвращает результат 5.6.

Если один из параметров является плавающей, результатом будет INT с пакетом SDK javascript.

Пример

div(11.2, 2)

Возвращает результат 5.

Обходной путь для Javascript для хранения определенного количества десятичных знаков в результатах заключается в использовании такого выражения. Например, чтобы сохранить 3 десятичных разряда:

float(concat(string(div(a, b)),'.',string(mod(div(a*1000, b), 1000))))

empty

Проверяет, пуст ли экземпляр. Возвращает true, если входные данные пусты. Пустые входные данные означают:

• входные данные имеют значение NULL или не определены;
• входные данные имеют значение NULL или являются пустой строкой;
• входные данные являются коллекцией нулевого размера;
• входные данные являются объектом без свойства.

empty('<instance>')
empty([<instance>])

Параметр	Обязательное поле	Type	Описание
<instance>	Да	любое	Проверяемый экземпляр

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращается значение true, если экземпляр является пустым.

Пример

В этих примерах проверяется, является ли указанный экземпляр пустым.

empty('')
empty('abc')
empty([1])
empty(null)

И возвращаются такие результаты соответственно:

• передается пустая строка, поэтому функция возвращает true.
• Передается строка abc, поэтому функция возвращает false.
• Передает коллекцию с одним элементом, поэтому функция возвращает false.
• Передает объект NULL, поэтому функция возвращает true.

endsWith

Проверяет, заканчивается ли строка определенной подстрокой. Возвращает true, если подстрока найдена, или false в противном случае. Эта функция не учитывает регистр.

endsWith('<text>', '<searchText>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Проверяемая строка
<searchText>	Да	строка	Конечная подстрока для поиска

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает значение true, если конечная подстрока обнаружена. Возвращает false, если не обнаружена.

Пример 1

В этом примере проверяется, заканчивается ли строка hello world строкой world.

endsWith('hello world', 'world')

И возвращается результат true.

Пример 2

В этом примере проверяется, заканчивается ли строка hello world строкой universe.

endsWith('hello world', 'universe')

И возвращается результат false.

EOL

Возвращает текст последовательности строки (EOL).

EOL()

Возвращаемое значение	Тип	Описание
<IsOSPlatform>	строка	Возвращает \r\n в Windows и \n в Mac и Linux.

Пример

В этом примере проверяется конец текста последовательности строк:

EOL()

И возвращает следующие строки:

• Windows: \r\n
• Mac или Linux: \n

равно

Проверяет, эквивалентны ли оба значения, выражения или объекта. Возвращается значение true, если они эквивалентны, или false, если нет.

equals('<object1>', '<object2>')

Параметр	Обязательное поле	Type	Описание
<object1>, <object2>	Да	любое	Значения, выражения или объекты для сравнения

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает значение true, если оба значения эквивалентны. Возвращает значение false, если это не так.

Пример

В этих примерах проверяется, являются ли указанные входные данные эквивалентными.

equals(true, 1)
equals('abc', 'abcd')

И возвращаются такие результаты:

• оба значения эквивалентны, поэтому функция возвращает true.
• оба значения не эквивалентны, поэтому функция возвращает false.

существует

Проверяет истинность выражения.

exists(expression)

Параметр	Обязательное поле	Type	Описание
выражение	Да	выражение	Выражение, которое будет проверяться на истинность.

Возвращаемое значение	Тип	Описание
<true или false>	Логический	Результат проверки выражения.

Пример

В следующих примерах проверяется истинность foo = {"bar":"value"}.

exists(foo.bar)
exists(foo.bar2)

И возвращаются такие результаты соответственно:

• true
• false

exp

Возвращает результат возведения указанного числа в указанную степень.

exp(realNumber, exponentNumber)

Параметр	Обязательное поле	Type	Описание
realNumber	Да	number	Вещественное число для вычисления степени.
exponentNumber	Да	number	Показатель степени.

Возвращаемое значение	Тип	Описание
<result-exp>	number	Результат возведения realNumber в указанную степень.

Пример

В этом примере вычисляется степень числа.

exp(2, 2)

И возвращается результат 4.

первая

Возвращает первый элемент из строки или массива.

first('<collection>')
first([<collection>])

Параметр	Обязательное поле	Type	Описание
<collection>	Да	строка или массив	Коллекция, в которой нужно найти первый элемент.

Возвращаемое значение	Тип	Описание
<первый элемент коллекции>	любое	Первый элемент в коллекции

Пример

В этих примерах выполняется поиск первого элемента в следующих коллекциях.

first('hello')
first(createArray(0, 1, 2))

И возвращаются такие результаты соответственно:

• ч
• 0

flatten

Преобразует массив в плоскую структуру, чтобы его значения не являлись массивами. Вы можете указать необязательный параметр максимальной глубины преобразования.

flatten([<collection>], '<depth>')

Параметр	Обязательное поле	Type	Описание
<collection>	Да	array	Коллекция для преобразования в плоскую структуру.
<depth>	No	number	Максимальная глубина для преобразования в плоскую структуру. По умолчанию не имеет ограничений.

Возвращаемое значение	Тип	Описание
<new-collection>	array	Новая коллекция, элементы которой преобразованы в плоскую структуру до указанной глубины.

Пример 1

В этом примере следующий массив преобразуется в плоскую структуру.

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)))

И возвращается результат [1, 2, 3, 4, 5, 6].

Пример 2

В этом примере массив преобразуется в плоскую структуру до глубины 1.

flatten(createArray(1, createArray(2), createArray(createArray(3, 4), createArray(5, 6)), 1)

И возвращается результат [1, 2, [3, 4], [5, 6]].

с плавающей запятой

Преобразует строковую версию числа с плавающей запятой в числовое представление. Эта функция используется только при передаче пользовательских параметров в приложение, такое как приложение логики. Исключение будет создано, если строка не может быть преобразована в float.

float('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Строка для преобразования, содержащая допустимое представление числа с плавающей запятой.

Возвращаемое значение	Тип	Описание
<значение с плавающей запятой>	с плавающей запятой	Число с плавающей запятой, полученное из указанной строки.

Пример

В этом примере преобразуется плавающая версия строки:

float('10.333')

И возвращает значение float 10,333.

floor

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

floor('<number>')

Параметр	Обязательное поле	Type	Описание
<number>	Да	number	Входной номер

Возвращаемое значение	Тип	Описание
<целочисленное значение>	integer	Наибольшее целочисленное значение меньше или равно входное число

Пример

В этом примере вычисляется значение пола числа 10,333:

floor(10.333)

И возвращает целое число 10.

foreach

Обрабатывает каждый элемент и возвращают новую коллекцию.

foreach([<collection/instance>], <iteratorName>, <function>)

Параметр	Обязательное поле	Type	Описание
<collection/instance>	Да	массив или объект	Коллекция с элементами.
<iteratorName>	Да	Имя итератора.	Ключевой элемент стрелочной функции.
<function>	Да	выражение	Функция, которая содержит iteratorName.

Возвращаемое значение	Тип	Описание
<new-collection>	array	Новая коллекция, в которой к каждому элементу применена оценка указанной функцией.

Пример 1

В этом примере создается новая коллекция.

foreach(createArray(0, 1, 2, 3), x, x + 1)

И возвращается результат [1, 2, 3, 4].

Пример 2

В этих примерах создается новая коллекция:

foreach(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
foreach(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

И возвращает результат ['name:jack', 'age:15']. Обратите внимание, что второе выражение является лямбда-выражением, которое некоторые находят более удобочитаемым.

formatDateTime

Возвращает метку времени в необязательном формате языкового стандарта.

formatDateTime('<timestamp>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<метка времени в другом формате>	строка	Обновленная метка времени в указанном формате

Пример 1

В этом примере метка времени преобразуется в указанный формат:

formatDateTime('03/15/2018 12:00:00', 'yyyy-MM-ddTHH:mm:ss')

И возвращает результат 2018-03-15T12:00:00.

Пример 2

В этом примере преобразуется метка времени в языковом стандарте de-DE :

formatDateTime('2018-03-15', '', 'de-DE')

И возвращает результат 15.03.18 00:00:00.

formatEpoch

Возвращает метку времени в необязательном формате языкового стандарта в указанном формате из времени UNIX (также известное как эпоха, время POSIX, время эпохи UNIX).

formatEpoch('<epoch>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<epoch>	Да	number	Номер эпохи
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<метка времени в другом формате>	строка	Обновленная метка времени в указанном формате

Пример

В этом примере метка времени Unix преобразуется в указанный формат:

formatEpoch(1521118800, 'yyyy-MM-ddTHH:mm:ss.fffZ)'

И возвращается результат 2018-03-15T12:00:00.000Z.

Пример

В этом примере преобразуется метка времени Unix в языковом стандарте de-DE :

formatEpoch(1521118800, '', 'de-DE')

И возвращает результат 15.03.18 13:00:00.

formatNumber

Отформатируйте значение до указанного числа дробных цифр и дополнительного языкового стандарта.

formatNumber('<number>', '<precision-digits>', '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<number>	Да	number	Входной номер
<точность цифр>	Да	integer	Указанное число дробных цифр
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<return-value>	number	Возвращаемое значение входного формата по указанному числу дробных цифр и указанному языковому стандарту

Пример 1

В этом примере число 10,333 до 2 дробных цифр:

formatNumber(10.333, 2)

И возвращает строку 10.33.

Пример 2

В этих примерах цифры форматироваться до указанного числа цифр в языковом стандарте en-US :

formatNumber(12.123, 2, 'en-US')
formatNumber(1.551, 2, 'en-US')
formatNumber(12.123, 4, 'en-US')

И возвращаются следующие результаты соответственно:

• 12.12
• 1.55
• 12.1230

formatTicks

Возвращает метку времени в необязательном формате языкового стандарта в указанном формате из галок.

formatTicks('<ticks>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<epoch>	Да	число (или bigint в JavaScript)	Число тактов
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<метка времени в другом формате>	строка	Обновленная метка времени в указанном формате

Пример 1

В этом примере такты преобразуются в указанный формат:

formatTicks(637243624200000000, 'yyyy-MM-ddTHH:mm:ss.fffZ')

И возвращается результат 2020-05-06T11:47:00.000Z.

Пример 2

В этом примере галочки преобразуются в указанный формат в языковом стандарте de-DE :

formatTicks(637243624200000000, '', 'de-DE')

И возвращает результат 06.05.20 11:47:00.

getFutureTime

Возвращает текущую метку времени в необязательном формате языкового стандарта и указанные единицы времени.

getFutureTime(<interval>, <timeUnit>, '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<interval>	Да	integer	Число указанных единиц времени для добавления.
<timeUnit>	Да	строка	Единица измерения времени, которая будет применяться к значению interval: Поддерживаются следующие единицы: Second (секунда), Minute (минута), Hour (час), Day (день), Week (неделя), Month (месяц) и Year (год).
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Текущая метка времени и указанное число единиц времени

Пример 1

Допустим, текущая метка времени такая: 2019-03-01T00:00:00.000Z. В следующем примере к этой метке времени добавляются пять дней.

getFutureTime(2, 'Week')

И возвращается результат 2019-03-15T00:00:00.000Z.

Пример 2

Допустим, текущая метка времени такая: 2018-03-01T00:00:00.000Z. В следующем примере к этой метке времени добавляются пять дней и результат преобразуется в формат MM-DD-YY.

getFutureTime(5, 'Day', 'MM-DD-YY')

И возвращает результат 03-06-18.

Пример 3

Предположим, что текущая метка времени — 2020-05-01T00:00:00.000Z , а языковой стандарт — de-DE. В приведенном ниже примере к метке времени добавляется 1 день:

getFutureTime(1,'Day', '', 'de-DE')

И возвращает результат 02.05.20 00:00:00.

getNextViableDate

Возвращает следующую жизнеспособную дату выражения Timex на основе текущей даты и дополнительно указанного часового пояса.

getNextViableDate(<timexString>, <timezone>?)

Параметр	Обязательное поле	Type	Описание
<timexString>	Да	строка	Строка Timex для оценки даты.
<timezone>	Нет	строка	Необязательный часовой пояс.

Возвращаемое значение	Тип	Описание
<nextViableTime>	строка	Следующая жизнеспособная дата.

Примеры

Предположим, что дата — 2020-06-12 , а текущее время — 15:42:21.

В этих примерах вычисляется строка Timex для следующей жизнеспособной даты на основе указанной выше даты и времени:

getPreviousViableDate("XXXX-12-20", "America/Los_Angeles")
getPreviousViableDate("XXXX-02-29")

И возвращает следующие строки соответственно:

• 2020-12-20
• 2024-02-29

getNextViableTime

Возвращает следующее жизнеспособное время выражения Timex на основе текущего времени и дополнительно указанного часового пояса.

getNextViableTime(<timexString>, <timezone>?)

Параметр	Обязательное поле	Type	Описание
<timexString>	Да	строка	Строка Timex времени для вычисления.
<timezone>	Нет	строка	Необязательный часовой пояс.

Возвращаемое значение	Тип	Описание
<nextViableTime>	строка	Следующее жизнеспособное время.

Примеры

Предположим, что дата — 2020-06-12 , а текущее время — 15:42:21.

В этих примерах вычисляется строка Timex для следующего жизнеспособного времени на основе указанной выше даты и времени:

getNextViableTime("TXX:12:14", "Asia/Tokyo")
getNextViableTime("TXX:52:14")

И возвращает следующие строки соответственно:

• T16:12:14
• T15:52:14

getPastTime

Возвращает текущую метку времени, вычитая указанные единицы времени.

getPastTime(<interval>, <timeUnit>, '<format>'?)

Параметр	Обязательное поле	Type	Описание
<interval>	Да	integer	Количество единиц времени для вычитания
<timeUnit>	Да	строка	Единица измерения времени, которая будет применяться к значению interval: Поддерживаются следующие единицы: Second (секунда), Minute (минута), Hour (час), Day (день), Week (неделя), Month (месяц) и Year (год).
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Текущая метка времени за вычетом указанного числа единиц времени

Пример 1

Допустим, текущая метка времени такая: 2018-02-01T00:00:00.000Z. В этом примере от указанной метки времени отнимается пять дней.

getPastTime(5, 'Day')

И возвращается результат 2019-01-27T00:00:00.000Z.

Пример 2

Допустим, текущая метка времени такая: 2018-03-01T00:00:00.000Z. В этом примере вычитается пять дней до метки времени в формате MM-DD-YY :

getPastTime(5, 'Day', 'MM-DD-YY')

И возвращает результат 02-26-18.

Пример 3

Предположим, что текущая метка времени — 2020-05-01T00:00:00.000Z , а языковой стандарт — de-DE. В приведенном ниже примере вычитается 1 день из метки времени:

getPastTime(1,'Day', '', 'de-DE')

И возвращает результат 31.04.20 00:00:00.

getPreviousViableDate

Возвращает предыдущую жизнеспособную дату выражения Timex на основе текущей даты и дополнительно указанного часового пояса.

getPreviousViableDate(<timexString>, <timezone>?)

Параметр	Обязательное поле	Type	Описание
<timexString>	Да	строка	Строка Timex для оценки даты.
<timezone>	Нет	строка	Необязательный часовой пояс.

Возвращаемое значение	Тип	Описание
<previousViableDate>	строка	Предыдущая жизнеспособная дата.

Примеры

Предположим, что дата — 2020-06-12 , а текущее время — 15:42:21.

В этих примерах вычисляется строка Timex для предыдущей жизнеспособной даты на основе указанной выше даты и времени:

getPreviousViableDate("XXXX-12-20", "Eastern Standard Time")
getPreviousViableDate("XXXX-02-29")

И возвращает следующие строки соответственно:

• 2019-12-20
• 2020-02-29

getPreviousViableTime

Возвращает предыдущее жизнеспособное время выражения Timex на основе текущей даты и дополнительно заданного часового пояса.

getPreviousViableTime(<timexString>, <timezone>?)

Параметр	Обязательное поле	Type	Описание
<timexString>	Да	строка	Строка Timex времени для вычисления.
<timezone>	Нет	строка	Необязательный часовой пояс.

Возвращаемое значение	Тип	Описание
<previousViableTime>	строка	Предыдущее жизнеспособное время.

Примеры

Предположим, что дата — 2020-06-12 , а текущее время — 15:42:21.

В этих примерах вычисляется строка Timex для предыдущего жизнеспособного времени на основе указанной выше даты и времени:

getPreviousViableTime("TXX:52:14")
getPreviousViableTime("TXX:12:14", 'Europe/London')

И возвращает следующие строки соответственно:

• T14:52:14
• T15:12:14

getProperty

Возвращает значение указанного свойства или корневого свойства из объекта JSON.

Возвращает значение указанного свойства

getProperty(<JSONObject>, '<propertyName>')

Параметр	Обязательное поле	Type	Описание
<JSONObject>	Да	объект	Объект JSON, содержащий свойство и значения.
<propertyName>	Нет	строка	Имя необязательного свойства для доступа к значениям из.

Возвращаемое значение	Тип	Описание
значение	строка	Значение указанного свойства в объекте JSON.

Пример

Предположим, что у вас есть следующий объект JSON:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

В этом примере извлекается указанное свойство из приведенного выше объекта JSON:

getProperty({"a:b": "value"}, 'a:b')
getProperty(c, 'd')

И возвращает следующие строки соответственно:

• a:b value
• d key

Возврат корневого свойства

getProperty('<propertyName>')

Параметр	Обязательное поле	Type	Описание
<propertyName>	Да	строка	Имя необязательного свойства для доступа к значениям из корневой области памяти.

Возвращаемое значение	Тип	Описание
значение	строка	Значение корневого свойства в объекте JSON.

Пример

Предположим, что у вас есть следующий объект JSON:

{
   "a:b" : "a:b value",
   "c":
   {
        "d": "d key"
    }
}

В этом примере извлекается корневое свойство из приведенного выше объекта JSON:

getProperty("a:b")

И возвращает строку a:b value.

getTimeOfDay

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

getTimeOfDay('<timestamp>')

Это может быть одна из следующих строк.

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая исходную метку времени.

Возвращаемое значение	Тип	Описание
<time-of-day>	строка	Время дня, полученное для указанной метки времени.

Ниже перечислены строки, которые могут обозначать время дня.

Время дня	Метка времени
midnight	24:00
morning (утро)	00:01–11:59
afternoon (день)	12:00
evening (вечер)	18:00–22:00
ночь	22:01–23:59

Пример

getTimeOfDay('2018-03-15T08:00:00.000Z')

Возвращается значение morning (утро).

greater

Проверяет, является ли первое значение большим, чем второе. Возвращает значение true, если первое значение больше второго, или false в противном случае.

greater(<value>, <compareTo>)
greater('<value>', '<compareTo>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	Целое число, число с плавающей запятой или строка.	Проверяет, является ли первое значение большим, чем второе
<compareTo>	Да	Целое число, число с плавающей запятой или строка соответственно.	Значение сравнения

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает true, если первое значение больше второго. Возвращает false, если первое значение меньше второго или равно ему.

Пример

В этих примерах проверяется, является ли первое значение большим, чем второе.

greater(10, 5)
greater('apple', 'banana')

И возвращаются следующие результаты соответственно:

• true
• false

greaterOrEquals

Проверяет, является ли первое значение большим, чем второе, или равным ему. Возвращает true, если первое значение больше второго или равно ему, или false в противном случае.

greaterOrEquals(<value>, <compareTo>)
greaterOrEquals('<value>', '<compareTo>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	Целое число, число с плавающей запятой или строка.	Проверяет, является ли первое значение большим, чем второе, или равным ему
<compareTo>	Да	Целое число, число с плавающей запятой или строка соответственно.	Значение сравнения

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает true, если первое значение больше второго или равно ему. Возвращает false, если первое значение меньше второго.

Пример

В этих примерах проверяется, является ли первое значение большим чем второе, или равным ему.

greaterOrEquals(5, 5)
greaterOrEquals('apple', 'banana')

И возвращаются следующие результаты соответственно:

• true
• false

if

Проверьте, какое значение имеет выражение: true или false. Возвращает указанное значение на основе результата.

if(<expression>, <valueIfTrue>, <valueIfFalse>)

Параметр	Обязательное поле	Type	Описание
<выражение>	Да	Логический	Выражение для вычисления
<valueIfTrue>	Да	любое	Возвращаемое значение, если выражение истинно.
<valueIfFalse>	Да	любое	Возвращаемое значение, если выражение ложно.

Возвращаемое значение	Тип	Описание
<указанное возвращаемое значение>	любое	Указанное значение, которое возвращается в зависимости от результата вычисления выражения: true или false.

Пример

В этом примере вычисляется, является ли equals(1,1) истинным.

if(equals(1, 1), 'yes', 'no')

Здесь возвращается значение yes, так как указанное выражение возвращает результат true. В противном случае этот пример возвращал бы no.

indexOf

Возвращает начальную позицию или значение индекса для подстроки. Эта функция не учитывает регистр, а значения индексов начинаются с 0.

indexOf('<text>', '<searchText>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка или массив	Строки, которая содержит подстроку для поиска
<searchText>	Да	строка	Подстрока для поиска

Возвращаемое значение	Тип	Описание
<значение индекса>	integer	Начальное положение или значение индекса указанной подстроки.
Если строка не найдена, возвращается число -1.

Пример 1

В этом примере выполняется поиск начального значения индекса для подстроки world в строке hello world.

indexOf('hello world', 'world')

И возвращается результат 6.

Пример 2

В этом примере выполняется поиск начального значения индекса для подстроки def в массиве ['abc', 'def', 'ghi']:

indexOf(createArray('abc', 'def', 'ghi'), 'def')

И возвращается результат 1.

indicesAndValues

Преобразует массив или объект в массив объектов, состоящих из индексов (текущий индекс) и свойств значений. Для массивов индекс обозначает положение в этом массиве. Для объектов это ключ для значения.

indicesAndValues('<collection or object>')

Параметр	Обязательное поле	Type	Описание
<коллекция или объект>	Да	массив или объект	Исходный массив или объект

Возвращаемое значение	Тип	Описание
<collection>	array	Новый массив. У каждого элемента есть два свойства: индекс, который обозначает положение в массиве или ключ в объекте, и соответствующее индексу значение.

Пример 1

Предположим, у вас есть такой список: { items: ["zero", "one", "two"] }. Следующая функция принимает этот список.

indicesAndValues(items)

И возвращает новый список.

[
  {
    index: 0,
    value: 'zero'
  },
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Пример 2

Предположим, у вас есть такой список: { items: ["zero", "one", "two"] }. Следующая функция принимает этот список.

where(indicesAndValues(items), elt, elt.index >= 1)

И возвращает новый список.

[
  {
    index: 1,
    value: 'one'
  },
  {
    index: 2,
    value: 'two'
  }
]

Пример 3

Предположим, у вас есть такой список: { items: ["zero", "one", "two"] }. Следующая функция принимает этот список.

join(foreach(indicesAndValues(items), item, item.value), ',')

И возвращается результат zero,one,two. Это выражение дает такой же результат, как и join(items, ',').

Пример 4

Предположим, что у вас есть объект {user: {name: "jack", возраст: 20} }. Следующая функция принимает этот объект.

indicesAndValues(user)

И возвращает новый объект.

[
  {
    index: 'name',
    value: 'jack'
  },
  {
    index: 'age',
    value: 20
  }
]

INT

Возвращает целочисленную версию строки. Исключение будет создано, если строка не может быть преобразована в целое число.

int('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Преобразуемая строка

Возвращаемое значение	Тип	Описание
<целочисленный результат>	integer	Целочисленная версия указанной строки.

Пример

В этом примере создается целочисленная версия для строки 10.

int('10')

И возвращается результат 10 (целое число).

intersection

Возвращает коллекцию, которая содержит только общие элементы в указанных коллекциях. Чтобы появиться в результатах, элемент должен находиться во всех коллекциях, переданных этой функции. Если один или несколько элементов имеют одинаковое имя, в результатах появляется последний элемент с таким именем.

intersection([<collection1>], [<collection2>], ...)
intersection('<collection1>', '<collection2>', ...)

Параметр	Обязательное поле	Type	Описание
<collection1>, <collection2>	Да	Массив или объект, но не оба типа сразу.	Коллекции, из которых нужно получить только общие элементы.

Возвращаемое значение	Тип	Описание
<общий элементы>	Массив или объект соответственно.	Коллекция, которая содержит только общие элементы в указанных коллекциях

Пример

В этом примере выполняется поиск общих элементов в следующих массивах.

intersection(createArray(1, 2, 3), createArray(101, 2, 1, 10), createArray(6, 8, 1, 2))

И возвращается массив только с элементами [1, 2].

isArray

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

isArray('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращается true , если заданный вход является массивом или возвращается false , если это не массив.

Примеры

В следующем примере производится проверка, является ли входное значение объектом.

isArray('hello')
isArray(createArray('hello', 'world'))

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает false;
• входные данные представляют собой массив, поэтому функция возвращает true;

isBoolean

Возвращает true, если входное значение является логическим.

isBoolean('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращает true, если получено логическое входное значение, или false в противном случае.

Примеры

В следующем примере производится проверка, является ли входное значение логическим.

isBoolean('hello')
isBoolean(32 > 16)

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает false;
• входные данные представляют собой логическое значение, поэтому функция возвращает true.

isDate

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на допустимую дату. Допустимыми считаются даты, для которых определены месяц и день месяца или день недели.

isDate('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращает true, если входные данные обозначают допустимую дату, или false в противном случае.

Примеры

В этих примерах производится проверка, являются ли входные значения допустимыми датами.

isDate('2020-12')
isDate('xxxx-12-21')

И возвращаются следующие результаты:

• false
• true

isDateRange

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на допустимый диапазон дат.

isDateRange('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращается true , если заданные входные данные относятся к допустимому диапазону дат или возвращаются false , если это недопустимый диапазон дат.

Примеры

В этих примерах производится проверка, являются ли входные значения допустимыми диапазонами дат.

isDateRange('PT30M')
isDateRange('2012-02')

И возвращаются следующие результаты:

• false
• true

isDateTime

Возвращает true, если полученные входные данные являются строкой с меткой времени в формате UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ).

isDateTime('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращается true , если заданный вход является строкой метки времени формата UTC ИЛИ возвращается false , если это не строка метки времени формата UTC.

Примеры

В следующих примерах производится проверка, является ли входное значение строкой в формате UTC ISO.

isDateTime('hello world!')
isDateTime('2019-03-01T00:00:00.000Z')

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает false;
• входные данные представляют собой строку в формате UTC ISO, поэтому функция возвращает true.

isDefinite

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на допустимую дату. Допустимыми считаются даты, в которых определен год, месяц и день месяца.

isDefinite('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращается true , если указанные входные данные относятся к допустимой полной дате или возвращаются false , если она не ссылается на действительную полную дату.

Примеры

Предположим, у вас есть объект TimexProperty validFullDate = new TimexProperty("2020-02-20"), а свойство Now имеет значение true. В следующих примерах производится проверка, определяет ли этот объект допустимую полную дату.

isDefinite('xxxx-12-21')
isDefinite(validFullDate)

И возвращаются следующие результаты соответственно:

• false
• true

isDuration

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на допустимую длительность времени.

isDuration('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращает значение true, если входные данные определяют допустимую длительность, или false в противном случае.

Примеры

В примерах ниже производится проверка, являются ли входные значения допустимыми отрезками времени.

isDuration('PT30M')
isDuration('2012-02')

И возвращаются следующие результаты соответственно:

• true
• false

isFloat

Возвращает значение true, если входное значение является числом с плавающей запятой. Для сохранения согласованности между C# и JavaScript числом с плавающей запятой будет считаться любое число с ненулевым остатком от целочисленного деления на 1.

isFloat('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращается true , если заданный вход является числом с плавающей запятой или возвращается false , если входные данные не являются числом с плавающей запятой.

Примеры

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

isFloat('hello world!')
isFloat(1.0)
isFloat(12.01)

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает false;
• входные данные представляют собой число, у которого остаток от деления равен 0, поэтому функция возвращает false;
• входные данные представляют собой число с плавающей запятой, поэтому функция возвращает true.

isInteger

Возвращает значение true, если входное значение является целым числом. Для сохранения согласованности между C# и JavaScript целым числом будет считаться любое число с нулевым остатком от целочисленного деления на 1.

isInteger('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Является ли входное значение целым числом.

Примеры

В следующих примерах производится проверка, является ли входное значение целым числом.

isInteger('hello world!')
isInteger(1.0)
isInteger(12)

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает false;
• входные данные представляют собой число, у которого остаток от деления равен 0, поэтому функция возвращает true;
• входные данные представляют собой целое число, поэтому функция возвращает true.

isMatch

Возвращает true, если полученная строка соответствует указанному шаблону регулярного выражения.

isMatch('<target**string>', '<pattern>')

Параметр	Обязательное поле	Type	Описание
<target**string>	Да	строка	Строка для сопоставления.
<pattern>	Да	строка	Шаблон регулярного выражения.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращается true , если заданная строка соответствует общему шаблону регулярного выражения или возвращается false , если он не соответствует шаблону.

Примеры

В следующем примере проверяется, соответствует ли входное значение заданному шаблону регулярного выражения.

isMatch('ab', '^[a-z]{1,2}$')
isMatch('FUTURE', '(?i)fortune|future')
isMatch('12abc34', '([0-9]+)([a-z]+)([0-9]+)')
isMatch('abacaxc', 'ab.*?c')

И возвращается то же значение true.

isObject

Возвращается true , если заданный вход является сложным объектом или возвращается false , если это примитивный объект. К примитивам относятся строки, числа и логические значения, а составными считаются типы, содержащие свойства, например классы.

isObject('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращается true , если заданный вход является сложным объектом или возвращается false , если это примитивный объект.

Примеры

В следующих примерах производится проверка, является ли входное значение объектом.

isObject('hello world!')
isObject({userName: "Sam"})

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает false;
• входные данные представляют собой объект, поэтому функция возвращает true.

IsPresent

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на настоящее время.

isPresent('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращается true , если входные данные относятся к настоящему или возвращают значение false, если он не ссылается на данный момент.

Примеры Предположим, у вас есть объект TimexProperty validNow = new TimexProperty() { Now = true }, а свойство Now имеет значениеtrue. В примерах ниже производится проверка, указывают ли входные значения на текущий момент.

isPresent('PT30M')
isPresent(validNow)

И возвращаются следующие результаты соответственно:

• false
• true

isString

Возвращает true, если входное значение является строкой.

isString('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	любое	Входное значение для проверки.

Возвращаемое значение	Тип	Описание
<Boolean-result>	Логический	Возвращает true, если получено строковое входное значение, или false в противном случае.

Примеры

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

isString('hello world!')
isString(3.14)

И возвращаются следующие результаты соответственно:

• входные данные представляют собой строку, поэтому функция возвращает true;
• входные данные представляют собой число с плавающей запятой, поэтому функция возвращает false.

isTime

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на допустимое время. Допустимым считается время, для которого определены час, минута и секунда.

isTime('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращает значение true, если входные данные определяют допустимое время, или false в противном случае.

Примеры

В этих примерах проверяется, относится ли следующий входной код к допустимому времени:

isTime('PT30M')
isTime('2012-02-21T12:30:45')

И возвращаются следующие результаты соответственно:

• false
• true

isTimeRange

Возвращает значение true, если полученный объект TimexProperty или выражение Timex указывает на допустимый диапазон времени. Допустимыми считаются диапазоны времени, в которых определено время дня.

isTime('<input>')

Параметр	Обязательное поле	Type	Описание
<input>	Да	Объект или строка	Входные данные в формате объекта TimexProperty или строки выражения Timex.

Возвращаемое значение	Тип	Описание
<boolean-result>	Логический	Возвращает значение true, если входные данные определяют допустимый диапазон времени, или false в противном случае.

Примеры

Предположим, у вас есть объект TimexProperty validTimeRange = new TimexProperty() { PartOfDay = "morning" }, а свойство Now имеет значение true. В этих примерах производится проверка, являются ли входные значения допустимыми диапазонами времени.

isTimeRange('PT30M')
isTimeRange(validTimeRange)

И возвращаются следующие результаты соответственно:

• false
• true

join

Возвращает строку, содержащую все элементы из массива, где каждый символ отделен разделителем.

join([<collection>], '<delimiter>')

Параметр	Обязательное поле	Type	Описание
<collection>	Да	array	Массив, который содержит элементы для объединения
<разделитель>	Да	строка	Разделитель, содержащийся между каждым символом в результирующей строке

Возвращаемое значение	Тип	Описание
<char1><delimiter><char2><delimiter>...	строка	Полученная строка, созданная из всех элементов в указанном массиве

Пример

В этом примере создается строка из всех элементов в этом массиве с указанным символом . в качестве разделителя:

join(createArray('a', 'b', 'c'), '.')

И возвращается результат a.b.c.

jPath

В указанном объекте или строке JSON проверяет наличие узлов или значений, которые соответствуют выражению пути, и возвращает найденные узлы.

jPath(<json>, '<path>')

Параметр	Обязательное поле	Type	Описание
<json>	Да	любое	Объект или строка JSON для поиска узлов или значений, которые соответствуют значению выражения пути.
<path>	Да	любое	Выражение пути, используемое для поиска соответствующих узлов или значений JSON

Возвращаемое значение	Тип	Описание
[ <json-node>]	array	Список узлов ИЛИ значений JSON, которые соответствуют указанному выражению пути

Пример для C#

Предположим, у вас есть следующий объект JSON.

{
    "Stores": [
        "Lambton Quay",
        "Willis Street"
    ],
    "Manufacturers": [
        {
            "Name": "Acme Co",
            "Products": [
                {
                    "Name": "Anvil",
                    "Price": 50
                }
            ]
        },
        {
            "Name": "Contoso",
            "Products": [
                {
                    "Name": "Elbow Grease",
                    "Price": 99.95
                },
                {
                    "Name": "Headlight Fluid",
                    "Price": 4
                }
            ]
        }
    ]
}

Выражение пути — $.. Продукты[?( @. Цена >= 50)]. Имя

jPath(jsonStr, path)

В этом примере возвращается результат ["Anvil", "Elbow Grease"].

Пример JavaScript

Предположим, у вас есть следующий объект JSON.

{
    "automobiles": [
        {
            "maker": "Nissan",
            "model": "Teana",
            "year": 2011
        },
        {
            "maker": "Honda",
            "model": "Jazz",
            "year": 2010
        },
        {
            "maker": "Honda",
            "model": "Civic",
            "year": 2007
        },
        {
            "maker": "Toyota",
            "model": "Yaris",
            "year": 2008
        },
        {
            "maker": "Honda",
            "model": "Accord",
            "year": 2011
        }
    ],
    "motorcycles": [
        {
            "maker": "Honda",
            "model": "ST1300",
            "year": 2012
        }
    ]
}

Выражение пути — .automobiles{.maker === "Honda" && .year > 2009}.model.

jPath(jsonStr, path)

В этом примере возвращается результат ['Jazz', 'Accord'].

json

Возвращает значение с типом JSON (нотация объектов JavaScript), объект с типом строки или XML.

json('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	Строка или XML	Строка или XML для преобразования

Возвращаемое значение	Тип	Описание
<результат JSON>	строка	Полученный объект JSON, созданный из указанной строки или XML.

Пример 1

В этом примере строка преобразуется в JSON.

json('{"fullName": "Sophia Owen"}')

И возвращается результат.

{
  "fullName": "Sophia Owen"
}

Пример 2

В этом примере строка XML преобразуется в JSON.

json(xml('<?xml version="1.0"?> <root> <person id='1'> <name>Sophia Owen</name> <occupation>Engineer</occupation> </person> </root>'))

И возвращается результат.

{
   "?xml": { "@version": "1.0" },
   "root": {
      "person": [ {
         "@id": "1",
         "name": "Sophia Owen",
         "occupation": "Engineer"
      } ]
   }
}

jsonStringify

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

Параметр	Обязательное поле	Type	Описание
<значение>	Да	объект	Объект для преобразования в строку JSON

Возвращаемое значение	Тип	Описание
<результат JSON>	строка	Результирующая строка JSON.

Примеры

В этих примерах показаны объекты, преобразованные в строки JSON:

jsonStringify(null)
jsonStringify({a:'b'})

И возвращает следующие результаты строки соответственно:

• NULL
• {"a":"b"}

последняя

Возвращает последний элемент из коллекции.

last('<collection>')
last([<collection>])

Параметр	Обязательное поле	Type	Описание
<collection>	Да	строка или массив	Коллекция, в которой нужно найти последний элемент.

Возвращаемое значение	Тип	Описание
<последний элемент коллекции>	Строка или массив соответственно.	Последний элемент в коллекции

Пример

Эти примеру ищут последний элемент в этих коллекциях:

last('abcd')
last(createArray(0, 1, 2, 3))

И возвращаются следующие результаты соответственно.

• дн.
• 3

lastIndexOf

Возвращает начальную позицию или значение индекса последнего вхождения подстроки. Эта функция не учитывает регистр, а значения индексов начинаются с 0.

lastIndexOf('<text>', '<searchText>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка или массив	Строки, которая содержит подстроку для поиска
<searchText>	Да	строка	Подстрока для поиска

Возвращаемое значение	Тип	Описание
<конечное значение индекса>	integer	Начальная позиция или значение индекса последнего вхождения указанной подстроки. Если строка не найдена, верните номер -1.

Пример 1

В этом примере выполняется поиск начального значения индекса для последнего вхождения подстроки world в строке hello world.

lastIndexOf('hello world', 'world')

И возвращается результат 6.

Пример 2

В этом примере выполняется поиск начального значения индекса для последнего вхождения подстроки def в массиве ['abc', 'def', 'ghi', 'def'].

lastIndexOf(createArray('abc', 'def', 'ghi', 'def'), 'def')

И возвращается результат 3.

length

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

length('<str>')

Параметр	Обязательное поле	Type	Описание
<str>	Да	строка	Строка, для которой вычисляется длина.

Возвращаемое значение	Тип	Описание
<length>	integer	Длина полученной строки.

Примеры

В этих примерах вычисляется длина строк.

length('hello')
length('hello world')

И возвращаются следующие результаты соответственно.

• 5
• 11

less

Проверяет, является ли первое значение меньшим, чем второе. Возвращает true, если первое значение меньше второго, или false в противном случае.

less(<value>, <compareTo>)
less('<value>', '<compareTo>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	Целое число, число с плавающей запятой или строка.	Первое значение, для которого выполняется проверка того, является ли оно меньшим, чем второе.
<compareTo>	Да	Целое число, число с плавающей запятой или строка соответственно.	Элемент для сравнения

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает true, если первое значение меньше второго. Возвращает false, если первое значение больше второго или равно ему.

Примеры

В этих примерах проверяется, является ли первое значение меньшим, чем второе.

less(5, 10)
less('banana', 'apple')

И возвращаются следующие результаты соответственно:

• true
• false

lessOrEquals

Проверяет, является ли первое значение меньшим, чем второе, или равным ему. Возвращает true, если первое значение меньше второго или равно ему, или false в противном случае.

lessOrEquals(<value>, <compareTo>)
lessOrEquals('<value>', '<compareTo>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	Целое число, число с плавающей запятой или строка.	Проверяет, является ли первое значение меньшим, чем второе, или равным ему
<compareTo>	Да	Целое число, число с плавающей запятой или строка соответственно.	Элемент для сравнения

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает true, если первое значение меньше второго или равно ему. Возвращает false, если первое значение больше второго.

Пример

В этих примерах проверяется, является ли первое значение меньшим или равным второму.

lessOrEquals(10, 10)
lessOrEquals('apply', 'apple')

И возвращаются следующие результаты соответственно:

• true
• false

макс.

Возвращает наибольшее значение из списка или массива. Список или массив включительно в обоих концах.

max(<number1>, <number2>, ...)
max([<number1>, <number2>, ...])

Параметр	Обязательное поле	Type	Описание
<number1>, <number2>, ...	Да	number	Набор чисел, из которого требуется получить наибольшее значение
[<number1>, <number2>, ...]	Да	Массив чисел.	Массив чисел, из которого требуется получить наибольшее значение

Возвращаемое значение	Тип	Описание
<макс. значение>	number	Максимальное значение в указанном массиве или набор чисел

Примеры

В этих примерах извлекается наибольшее значение из набора чисел и массива:

max(1, 2, 3)
max(createArray(1, 2, 3))

И возвращается результат 3.

merge

Объединяет несколько объектов JSON или массив объектов.

merge(<json1>, <json2>, ...)

Параметр	Обязательное поле	Type	Описание
<json1>, <json2>, ...	Да	объекты или массив	Набор объектов JSON или массива для объединения.

Возвращаемое значение	Тип	Description
<result>	объект	Объединенный объект JSON или объединенные объекты массива.

Примеры

Предположим, что у вас есть следующие объекты JSON:

json1 = @"{
            'FirstName': 'John',
            'LastName': 'Smith',
            'Enabled': false,
            'Roles': [ 'User' ]
          }"
json2 =@"{
            'Enabled': true,
            'Roles': [ 'User', 'Admin' ]
          }"

В этом примере объединяются объекты JSON:

string(merge(json(json1), json(json2)))

И возвращает полученный объект {"FirstName":"John","LastName":"Smith","Enabled":true","Role":["User","Admin"]}.

Предположим, что вы хотите объединить объекты и список объектов вместе. В следующем примере объединяется объект JSON и массив объектов:

merge({k1:'v1'}, [{k2:'v2'}, {k3: 'v3'}], {k4:'v4'})

И возвращает объект { "k1": "v1", "k2": "v2", "k3": "v3", "k4": "v4" }.

мин

Возвращает наименьшее значение из набора чисел или массива.

min(<number1>, <number2>, ...)
min([<number1>, <number2>, ...])

Параметр	Обязательное поле	Type	Описание
<number1>, <number2>, ...	Да	number	Набор чисел, из которого требуется получить наименьшее значение
[<number1>, <number2>, ...]	Да	Массив чисел.	Массив чисел, из которого требуется получить наименьшее значение

Возвращаемое значение	Тип	Описание
<мин. значение>	number	Минимальное значение в указанном массиве или набор чисел.

Примеры

В этих примерах извлекается наименьшее значение из набора чисел и массива:

min(1, 2, 3)
min(createArray(1, 2, 3))

И возвращается результат 1.

mod

Возвращает остаток результата деления двух чисел. Чтобы получить целочисленный результат, см. раздел div().

mod(<dividend>, <divisor>)

Параметр	Обязательное поле	Type	Описание
<dividend>	Да	number	Число, которое нужно поделить на делитель
<divisor>	Да	number	Число, на которое делится делимое. Не может быть равен 0.

Возвращаемое значение	Тип	Описание
<остаток>	number	Остаток результата деления первого числа на второе

Пример

В этом примере первое число делится на второе:

mod(3, 2)

И возвращается результат 1.

Месяц

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

month('<timestamp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени

Возвращаемое значение	Тип	Описание
<number-of-month>	integer	Число, обозначающее месяц, для указанной метки времени.

Пример

month('2018-03-15T13:01:00.000Z')

И возвращается результат 3.

mul

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

mul(<multiplicand1>, <multiplicand2>)

Параметр	Обязательное поле	Type	Описание
<multiplicand1>	Да	Целое число или число с плавающей запятой.	Число для умножения на multiplicand2
<multiplicand2>	Да	Целое число или число с плавающей запятой.	Число, на которое умножается multiplicand1

Возвращаемое значение	Тип	Описание
<результат>	Целое число или число с плавающей запятой.	Произведение от умножения первого числа на второе

Примеры

В этом примере первое число умножается на второе:

mul(1, 2)
mul(1.5, 2)

И возвращаются следующие результаты соответственно:

• 2
• 3

newGuid

Возвращает строку с новым GUID.

newGuid()

Возвращаемое значение	Тип	Описание
<Guid-string>	строка	Новая строка в формате GUID, которая имеет длину 36 символов и примерно такой формат: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx

Пример

newGuid()

Возвращается результат следующего вида: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx.

not

Проверяет, имеет ли выражение значение false. Возвращает true, если выражение ложно, или false в противном случае.

not(<expression>)

Параметр	Обязательное поле	Type	Описание
<выражение>	Да	Логический	Выражение для вычисления

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает true, если выражение ложно. Возвращает false, если выражение истинно.

Пример 1

В этих примерах проверяется, все ли указанные выражения ложны:

not(false)
not(true)

И возвращаются следующие результаты соответственно:

• выражение имеет значение false, поэтому функция возвращает true.
• выражение имеет значение true, поэтому функция возвращает false.

Пример 2

В этих примерах проверяется, все ли указанные выражения ложны:

not(equals(1, 2))
not(equals(1, 1))

И возвращаются следующие результаты соответственно:

• выражение имеет значение false, поэтому функция возвращает true.
• выражение имеет значение true, поэтому функция возвращает false.

or

Проверяет, является ли хотя бы одно выражение истинным. Возвращает значение true, если хотя бы одно выражение истинно, или false, если все являются ложными.

or(<expression1>, <expression2>, ...)

Параметр	Обязательное поле	Type	Описание
<expression1>, <expression2>, ...	Да	Логический	Выражения, которые следует проверить

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает значение true, если хотя бы одно выражение истинно. Возвращает значение false, если все выражения ложны.

Пример 1

В этих примерах проверяется, является ли хотя бы одно выражение истинным:

or(true, false)
or(false, false)

И возвращаются следующие результаты соответственно:

• по крайней мере одно выражение имеет значение true, поэтому функция возвращает true.
• оба выражения имеют значения false, поэтому функция возвращает false.

Пример 2

В этих примерах проверяется, является ли хотя бы одно выражение истинным:

or(equals(1, 1), equals(1, 2))
or(equals(1, 2), equals(1, 3))

И возвращаются следующие результаты соответственно:

• по крайней мере одно выражение имеет значение true, поэтому функция возвращает true.
• оба выражения имеют значения false, поэтому функция возвращает false.

rand

Возвращает случайное целое число из указанного диапазона с включительным значением только в начале.

rand(<minValue>, <maxValue>)

Параметр	Обязательное поле	Type	Описание
<minValue>	Да	integer	Наименьшее целое число в диапазоне
<maxValue>	Да	integer	Целое число, следующее за наибольшим целым числом в диапазоне, которое функция может вернуть

Возвращаемое значение	Тип	Описание
<случайный результат>	integer	Случайное целое число, возвращаемое из указанного диапазона

Пример

Этот пример получает случайное целое число из указанного диапазона, исключая максимальное значение:

rand(1, 5)

И возвращается результат 1, 2, 3 или 4.

range

Возвращает массив целых чисел, который начинается с заданного целого числа.

range(<startIndex>, <count>)

Параметр	Обязательное поле	Type	Описание
<startIndex>	Да	integer	Целочисленное значение, которое является первым элементом массива.
<count>	Да	integer	Количество целых чисел в массиве

Возвращаемое значение	Тип	Описание
<range-result>	integer	Массив с целыми числами, который начинается с указанного индекса

Пример

В этом примере создается целочисленный массив, который начинается с указанного индекса 1 и имеет указанное число целых чисел: 4.

range(1, 4)

И возвращается результат [1, 2, 3, 4].

removeProperty

Удаляет свойство из объекта и возвращает обновленный объект.

removeProperty(<object>, '<property>')

Параметр	Обязательное поле	Type	Описание
<object>	Да	объект	Объект JSON, из которого вы хотите удалить свойство.
<свойство>	Да	строка	Имя удаляемого свойства.

Возвращаемое значение	Тип	Описание
<обновленный_объект>	объект	Обновленный объект JSON без указанного свойства

Пример

В этом примере свойство accountLocation удаляется из объекта customerProfile, который преобразуется в JSON с помощью функции json(), и возвращается обновленный объект.

removeProperty(json('customerProfile'), 'accountLocation')

replace

Заменяет подстроку указанной строкой и возвращает полученную строку. Эта функция учитывает регистр.

replace('<text>', '<oldText>', '<newText>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка, которая содержит заменяемую подстроку
<oldText>	Да	строка	Заменяемая подстрока
<newText>	Да	строка	Строка для замены

Возвращаемое значение	Тип	Описание
<обновленный текст>	строка	Обновленная строка после замены подстроки. Если подстрока не найдена, функция возвращает исходную строку.

Пример 1

В этом примере выполняется поиск подстроки old в строке the old string и заменяет old на new:

replace('the old string', 'old', 'new')

В качестве результата возвращается строка the new string.

Пример 2

При использовании escape-символов обработчик выражений обрабатывает их самостоятельно. Эта функция заменяет строки правильными escape-символами.

replace('hello\"', '\"', '\n')
replace('hello\n', '\n', '\\\\')
@"replace('hello\\', '\\', '\\\\')"
@"replace('hello\n', '\n', '\\\\')"

И возвращаются следующие результаты соответственно.

• hello\n
• Привет\\
• @"hello\\"
• @"hello\\"

replaceIgnoreCase

Заменяет подстроку указанной строкой и возвращает полученную строку. Эта функция не учитывает регистр.

replaceIgnoreCase('<text>', '<oldText>', '<newText>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка, которая содержит заменяемую подстроку
<oldText>	Да	строка	Заменяемая подстрока
<newText>	Да	строка	Строка для замены

Возвращаемое значение	Тип	Описание
<обновленный текст>	строка	Обновленная строка после замены подстроки. Если подстрока не найдена, возвращает исходную строку.

Пример

В этом примере выполняется поиск подстроки old в строке the old string и заменяет old на new:

replace('the old string', 'old', 'new')

В результате возвращается строка the new string.

resolve

Возвращает строку заданного выражения TimexProperty или Timex, если он ссылается на допустимое время. Допустимое время содержит часы, минуты и секунды.

resolve('<timestamp')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени.

Возвращаемое значение	Тип	Описание
<return>	строка	Строка вычисляемого выражения TimexProperty или Timex.

Примеры

В этих примерах показано, относится ли заданные строки к допустимому времени:

resolve(T14)
resolve(2020-12-20)
resolve(2020-12-20T14:20)

И возвращаются следующие результаты соответственно.

• 14:00:00
• 2020-12-20
• 2020-12-20 14:20:00

reverse

Измените порядок элементов в строке или массиве.

reverse(<value>)

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка или массив	Строка для массива для обратного.

Возвращаемое значение	Тип	Описание
<return>	строка или массив	Обратные элементы строки или массива.

Примеры

Эти примеры возвращают элементы строки или массива.

reverse(hello)
reverse(concat(hello,world))

И возвращает следующие значения соответственно:

-Строка olleh. -Строка dlrowolleh.

round

Округление значения до ближайшего целого числа или указанного числа дробных цифр.

round('<number>', '<precision-digits>')

Параметр	Обязательное поле	Type	Описание
<number>	Да	number	Входной номер
<точность цифр>	No	integer	Указанное число дробных цифр. По умолчанию установлено значение 0.

Возвращаемое значение	Тип	Описание
<return-value>	number	Возвращаемое значение входного округления по указанному числу дробных цифр

Пример 1

В этом примере округляется число 10,333:

round(10.333)

И возвращает номер 10.

Пример 2

В этом примере число 10,3313 округляется до 2 дробных цифр:

round(10.3313, 2)

И возвращает номер 10,33.

select

Обрабатывает каждый элемент и возвращают новую коллекцию преобразованных элементов.

select([<collection/instance>], <iteratorName>, <function>)

Параметр	Обязательное поле	Type	Описание
<collection/instance>	Да	array	Коллекция с элементами.
<iteratorName>	Да	Имя итератора.	Ключевой элемент
<function>	Да	выражение	Функция, которая содержит iteratorName.

Возвращаемое значение	Тип	Описание
<new-collection>	array	Новая коллекция, в которой к каждому элементу применено преобразование указанной функцией.

Пример 1

В этом примере создается новая коллекция.

select(createArray(0, 1, 2, 3), x, x + 1)

И возвращается результат [1, 2, 3, 4].

Пример 2

В этих примерах создается новая коллекция:

select(json("{'name': 'jack', 'age': '15'}"), x, concat(x.key, ':', x.value))
select(json("{'name': 'jack', 'age': '15'}"), x=> concat(x.key, ':', x.value))

И возвращает результат ['name:jack', 'age:15']. Обратите внимание, что второе выражение является лямбда-выражением, которое некоторые находят более удобочитаемым.

предложениеCase

Заглавная буква первого слова в строке в необязательном формате языкового стандарта.

sentenceCase('<text>', '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Исходная строка
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
Строка результата	строка	Возвращает результат предложения

Пример 1

В этих примерах прописная буква в строке:

sentenceCase('a')
sentenceCase('abc def')
sentenceCase('aBC dEF')

И возвращаются следующие результаты соответственно:

• Объект
• Abc def
• Abc def

Пример 2

В этих примерах заглавная буква в строке в указанном формате языкового стандарта:

sentenceCase('a', 'fr-FR')
sentenceCase('abc', 'en-US')
sentenceCase('aBC', 'fr-FR')

И возвращаются следующие результаты соответственно:

• Объект
• Азбука
• Азбука

setPathToValue

Извлекает значение указанного свойства из объекта JSON.

setPathToValue(<path>, <value>)

Параметр	Обязательное поле	Type	Описание
<Путь>	Да	объект	Путь, который нужно задать.
<значение>	Да	объект	Значение, которое нужно присвоить этому пути.

Возвращаемое значение	Тип	Описание
значение	объект	Задаваемое значение.

Пример 1

В приведенном ниже примере задается значение пути 1.

setPathToValue(path.x, 1)

И возвращается результат 1. path.x получает значение 1.

Пример 2

В примере ниже присваивается значение.

setPathToValue(path.array[0], 7) + path.array[0]

И возвращается результат 14.

setProperty

Задает значение свойства объекта и возвращает обновленный объект. Чтобы добавить новое свойство, используйте эту функцию или функцию addProperty().

setProperty(<object>, '<property>', <value>)

Параметр	Обязательное поле	Type	Описание
<object>	Да	объект	Объект JSON, для которого вы хотите задать свойство.
<свойство>	Да	строка	Имя указываемого свойства.
<значение>	Да	любое	Значение, задаваемое для указанного свойства

Возвращаемое значение	Тип	Описание
<обновленный_объект>	объект	Обновленный объект JSON, свойство которого задается

Пример

В этом примере указывается свойство accountNumber в объекте customerProfile, который преобразуется в JSON с помощью функции json(). Функция присваивает значение, которое формируется функцией newGuid(), и возвращает обновленный объект JSON.

setProperty(json('customerProfile'), 'accountNumber', newGuid())

skip

Удаляет элементы из начала коллекции и возвращает все оставшиеся элементы.

skip([<collection>], <count>)

Параметр	Обязательное поле	Type	Описание
<collection>	Да	array	Коллекция, элементы которой требуется удалить
<count>	Да	integer	Положительное целое число для количества элементов в начале коллекции, которые требуется удалить

Возвращаемое значение	Тип	Описание
<обновленная коллекция>	array	Обновленная коллекция после удаления указанных элементов.

Пример

В этом примере удаляется один элемент, число 1, из начала указанного массива.

skip(createArray(0, 1, 2, 3), 1)

И возвращается массив с остальными его элементами: [1,2,3].

sortBy

Сортирует элементы коллекции по возрастанию и возвращает упорядоченную коллекцию.

sortBy([<collection>], '<property>')

Параметр	Обязательное поле	Type	Описание
<collection>	Да	строка или массив	Коллекция для сортировки.
<свойство>	Нет	строка	Сортирует элементы объектов в коллекции по указанному свойству, если оно задано.

Возвращаемое значение	Тип	Описание
<new-collection>	array	Новая коллекция с отсортированными элементами.

Пример 1

В этом примере сортируется следующая коллекция.

sortBy(createArray(1, 2, 0, 3))

И возвращается результат [0, 1, 2, 3].

Пример 2

Предположим, что у вас есть следующая коллекция.

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

В этом примере создается новая коллекция, отсортированная по значению свойства объекта x.

sortBy(nestedItems, 'x')

И возвращается результат.

{
  'nestedItems': [
    {'x': 1},
    {'x': 2},
    {'x': 3}
  ]
}

sortByDescending

Сортирует элементы коллекции по убыванию и возвращает упорядоченную коллекцию.

sortBy([<collection>], '<property>')

Параметр	Обязательное поле	Type	Описание
<collection>	Да	строка или массив	Коллекция для сортировки.
<свойство>	Нет	строка	Сортирует элементы объектов в коллекции по указанному свойству, если оно задано.

Возвращаемое значение	Тип	Описание
<new-collection>	array	Новая коллекция с отсортированными элементами.

Пример 1

В этом примере создается новая отсортированная коллекция.

sortByDescending(createArray(1, 2, 0, 3))

И возвращается результат [3, 2, 1, 0].

Пример 2

Предположим, что у вас есть следующая коллекция.

{
  'nestedItems': [
    {'x': 2},
    {'x': 1},
    {'x': 3}
  ]
}

В этом примере создается новая коллекция, отсортированная по значению свойства объекта x.

sortByDescending(nestedItems, 'x')

Возвращается такой результат:

{
  'nestedItems': [
    {'x': 3},
    {'x': 2},
    {'x': 1}
  ]
}

split

Возвращает массив, содержащий подстроки, разделенные запятыми, основываясь на указанном символе разделителя в исходной строке.

split('<text>', '<delimiter>'?)

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка для разделения на подстроки в зависимости от указанного разделителя в исходной строке. Если текст имеет значение NULL, он будет считаться пустой строкой.
<разделитель>	Нет	строка	Символ в исходной строке для использования в качестве разделителя. Если разделитель не предоставлен или имеет значение NULL, по умолчанию используется пустая строка.

Возвращаемое значение	Тип	Описание
[<substring1>,<substring2>,...]	array	Массив, содержащий подстроки из исходной строки, разделенные запятыми

Примеры

В этом примере создается массив подстрок из указанной строки путем разбивки с использованием указанного символа разделителя.

split('a**b**c', '**')
split('hello', '')
split('', 'e')
split('', '')
split('hello')

И возвращает следующие массивы соответственно:

• ["a", "b", "c"]
• ["h", "e", "l", "l", "o"]
• ["], [ ]
• ["h", "e", "l", "l", "o"]

sqrt

Возвращает квадратный корень указанного числа.

sqrt(<number>)

Параметр	Обязательное поле	Type	Описание
<number>	Да	number	Число для получения квадратного корня из

Возвращаемое значение	Тип	Description
<result>	number	Результат вычисления квадратного корня.

Примеры

В этих примерах вычисляется квадратный корень указанных чисел:

sqrt(9)
sqrt(0)

И возвращаются следующие результаты соответственно:

• 3
• 0

startOfDay

Возвращает начало дня для метки времени в необязательном формате языкового стандарта.

startOfDay('<timestamp>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
"<обновленная метка> времени"	строка	Обновленная метка времени, которая соответствует началу нулевого часа того же дня.

Пример 1

В этом примере выполняется поиск начала дня.

startOfDay('2018-03-15T13:30:30.000Z')

И возвращается результат 2018-03-15T00:00:00.000Z.

Пример 2

Этот пример находит начало дня с языковым стандартом fr-FR:

startOfDay('2018-03-15T13:30:30.000Z', '', 'fr-FR')

И возвращает результат 15.03.2018 00:00:00.

startOfHour

Возвращает начало часа метки времени в необязательном формате языкового стандарта.

startOfHour('<timestamp>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
"<обновленная метка> времени"	строка	Указанная метка времени, которая соответствует началу нулевой минуты дня.

Пример 1

В этом примере выполняется поиск начала часа.

startOfHour('2018-03-15T13:30:30.000Z')

И возвращается результат 2018-03-15T13:00:00.000Z.

Пример 2

В этом примере выполняется поиск начала часа с языковым стандартом fr-FR:

startOfHour('2018-03-15T13:30:30.000Z', '', 'fr-FR')

И возвращает результат 15.03.2018 13:00:00.

startOfMonth

Возвращает начало месяца для метки времени в необязательном формате языкового стандарта.

startOfMonth('<timestamp>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
"<обновленная метка> времени"	строка	Указанная метка времени, которая соответствует началу нулевого часа первого дня месяца.

Пример 1

В этом примере выполняется поиск начала месяца.

startOfMonth('2018-03-15T13:30:30.000Z')

И возвращается результат 2018-03-01T00:00:00.000Z.

Пример 2

В этом примере выполняется поиск начала месяца с языковым стандартом fr-FR:

startOfMonth('2018-03-15T13:30:30.000Z', '', 'fr-FR')

И возвращает результат 01.03.2018 00:00:00.

startsWith

Проверяет, начинается ли строка с определенной подстроки. Возвращает true, если подстрока найдена, или false в противном случае. Эта функция не учитывает регистр.

startsWith('<text>', '<searchText>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Проверяемая строка
<searchText>	Да	строка	Начальная подстрока для поиска.

Возвращаемое значение	Тип	Описание
true или false	Логический	Возвращает значение true, если обнаружена начальная подстрока. Возвращает false, если не обнаружена.

Пример 1

В этом примере проверяется, начинается ли строка hello world строкой hello:

startsWith('hello world', 'hello')

И возвращается результат true.

Пример 2

В этом примере проверяется, начинается ли строка hello world строкой greeting:

startsWith('hello world', 'greeting')

И возвращается результат false.

строка

Возвращает строковую версию значения в необязательном формате языкового стандарта.

string(<value>, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<значение>	Да	любое	Значение, которое необходимо преобразовать
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<строковое значение>	строка	Указанное значение в строковом формате.

Пример 1

В этом примере создается строковое представление числа 10.

string(10)

И возвращается строковое значение 10.

Пример 2

В этом примере создается строка для указанного объекта JSON и используется символ обратной косой черты \\ в качестве escape-символа для двойных кавычек ".

string( { "name": "Sophie Owen" } )

И возвращает результат { "name": "Софи Оуэн" }

Пример 3

В этом примере создается строковая версия номера 10 в определенном языковом стандарте:

string(100.1, 'fr-FR')
string(100.1, 'en-US')

И возвращает следующие строки соответственно:

• 100,1
• 100.1

stringOrValue

Обтекайте интерполяцию строк, чтобы получить реальное значение. Например, stringOrValue('${1}') возвращает число 1, в то время как stringOrValue('${1} item') возвращает строку "1 элемент".

stringOrValue(<string>)

Параметр	Обязательное поле	Type	Описание:
<string>	Да	строка	Строка для получения реального значения.

Возвращаемое значение	Тип	Description
<result>	любое	Результат получения реального значения указанной строки.

Примеры

В этих примерах показано, как получить реальное значение из строки:

stringOrValue('${one}')
stringOrValue('${one} item')

И возвращаются следующие результаты соответственно:

• Номер 1.0.
• Элемент строки 1.

дочерний объект

Вычитает второе число из первого числа и возвращает результат.

sub(<minuend>, <subtrahend>)

Параметр	Обязательное поле	Type	Описание
<minuend>	Да	number	Число, из которого вычитается вычитаемое
<subtrahend>	Да	number	Число, которое вычитается из уменьшаемого

Возвращаемое значение	Тип	Description
<result>	number	Вычитается второе число из первого числа и возвращается результат

Пример

В этом примере из первого числа вычитается второе число:

sub(10.3, .3)

И возвращается результат 10.

subArray

Возвращает подмассив на основе указанной начальной и конечной позиций. Значения индекса начинаются с числа 0.

subArray(<Array>, <startIndex>, <endIndex>)

Параметр	Обязательное поле	Type	Описание
<array>.	Да	array	Массив, из которого нужно извлечь подмассив.
<startIndex>	Да	integer	Положительное число (или 0), которое обозначает начальную позицию или значение индекса.
<endIndex>	Да	integer	Положительное число (или 0), которое обозначает конечную позицию или значение индекса.

Возвращаемое значение	Тип	Описание
<subarray-result>	array	Подмассив с указанным количеством элементов, начиная с указанной позиции индекса в исходной строке

Пример

В этом примере создается подмассив из указанного массива.

subArray(createArray('H','e','l','l','o'), 2, 5)

И возвращается результат ["l", "l", "o"].

substring

Возвращает символы из строки, начиная с указанной позиции или индекса. Значения индекса начинаются с числа 0.

substring('<text>', <startIndex>, <length>)

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка, из которой нужно извлечь подстроку.
<startIndex>	Да	integer	Положительное число (или 0), которое обозначает начальную позицию или значение индекса для подмассива.
<length>	Да	integer	Положительное число символов для подмассива в подстроке.

Возвращаемое значение	Тип	Описание
<результат подстроки>	строка	Подстрока с указанным количеством символов, начиная с указанной позиции индекса в исходной строке

Пример

В этом примере создается пятисимвольная подстрока из указанной строки, начиная со значения индекса 6:

substring('hello world', 6, 5)

И возвращается результат world.

subtractFromTime

Вычитайте количество единиц времени из метки времени в необязательном формате языкового стандарта. См. раздел getPastTime().

subtractFromTime('<timestamp>', <interval>, '<timeUnit>', '<format>'?, '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени
<interval>	Да	integer	Число единиц времени для вычитания
<timeUnit>	Да	строка	Единица измерения времени, которая будет применяться к значению interval: Поддерживаются следующие единицы: Second (секунда), Minute (минута), Hour (час), Day (день), Week (неделя), Month (месяц) и Year (год).
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<обновленная_метка_времени>	строка	Метка времени, от которой отнято указанное число единиц времени

Пример 1

В этом примере вычитается один день из следующей метки времени:

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day')

И возвращается результат 2018-01-01T00:00:00.000Z.

Пример 2

В этом примере вычитается один день из метки времени с помощью формата D :

subtractFromTime('2018-01-02T00:00.000Z', 1, 'Day', 'D')

И возвращает результат в понедельник, 1 января 2018 года.

Пример 3

В этом примере вычитается 1 час из метки времени в языковом стандарте de-DE :

subtractFromTime('2018-03-15T13:00:00.000Z', 1, 'Hour', '', 'de-DE')

И возвращает результат 15.03.18 12:00:00.

sum

Возвращает результат сложения чисел из списка.

sum([<list of numbers>])

Параметр	Обязательное поле	Type	Описание
[<list of numbers>]	Да	Массив чисел.	Числа для добавления

Возвращаемое значение	Тип	Описание
<итоговая_сумма>	number	Возвращает результат сложения указанных чисел

Пример

В этом примере добавляются указанные числа:

sum(createArray(1, 1.5))

И возвращается результат 2,5.

take

Возвращает элементы, расположенные в начале коллекции.

take('<collection>', <count>)
take([<collection>], <count>)

Параметр	Обязательное поле	Type	Описание
<collection>	Да	строка или массив	Коллекция, элементы которой требуется получить
<count>	Да	integer	Положительное целое число для количества элементов в начале коллекции, которые требуется получить.

Возвращаемое значение	Тип	Описание
<subset> или [<subset>]	Строка или массив соответственно	Строка или массив, который содержит заданное число элементов, взятых из первой части исходной коллекции

Пример

Эти примеры получают указанное количество элементов из первой части этих коллекций:

take('abcde', 3)
take(createArray(0, 1, 2, 3, 4), 3)

И возвращаются следующие результаты соответственно:

• abc
• [0, 1, 2]

ticks

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

ticks('<timestamp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка для метки времени

Возвращаемое значение	Тип	Описание
<число тактов>	целое число (bigint в JavaScript)	Число тактов с момента в указанной метке времени

Пример

В этом примере метка времени преобразуется в свойство тиков:

ticks('2018-01-01T08:00:00.000Z')

И возвращается результат 636503904000000000.

ticksToDays

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

ticksToDays('ticks')

Параметр	Обязательное поле	Type	Описание
<ticks>	Да	integer	Значение свойства тиков для преобразования

Возвращаемое значение	Тип	Описание
<число дней>	number	Количество дней, преобразованных из значения свойства ticks

Пример

В этом примере значение свойства тиков преобразуется в число дней:

ticksToDays(2193385800000000)

И возвращает номер 2538,64097222.

ticksToHours

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

ticksToHours('ticks')

Параметр	Обязательное поле	Type	Описание
<ticks>	Да	Целое	Значение свойства тиков для преобразования

Возвращаемое значение	Тип	Описание
<количество часов>	number	Количество часов, преобразованных из значения свойства тикса

Пример

В этом примере значение свойства тиков преобразуется в несколько часов:

ticksToHours(2193385800000000)

И возвращает номер 60927.38333333331.

ticksToMinutes

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

ticksToMinutes('ticks')

Параметр	Обязательное поле	Type	Описание
<ticks>	Да	integer	Значение свойства тиков для преобразования

Возвращаемое значение	Тип	Описание
<количество минут>	number	Количество минут, преобразованных из значения свойства тикса

Пример

В этом примере значение свойства тиков преобразуется в несколько минут:

ticksToMinutes(2193385800000000)

И возвращает номер 3655643.0185.

titleCase

Заглавная буква каждого слова в строке в необязательном локальном формате.

titleCase('<text>', '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Исходная строка
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
Строка результата	строка	Результат регистра заголовка

Пример 1

В этих примерах прописная буква каждого слова в строке:

titleCase('a')
titleCase('abc def')
titleCase('aBC dEF')

И возвращаются следующие результаты соответственно:

• Объект
• Abc Def
• Abc Def

Пример 2

В этих примерах заглавная буква в строке в формате en-US :

titleCase('a', 'en-US')
titleCase('aBC dEF', 'en-US')

И возвращаются следующие результаты соответственно:

• Объект
• Abc Def

toLower

Возвращает строку в нижнем регистре в необязательном формате языкового стандарта. Если символ в строке не имеет версии в нижнем регистре, он добавляется в возвращаемую строку без изменений.

toLower('<text>', '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка, возвращаемая в нижнем регистре
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<текст в нижнем регистре>	строка	Исходная строка в нижнем регистре

Пример 1

В этом примере строка преобразуется в нижний регистр.

toLower('Hello World')

И возвращается результат hello world.

Пример 2

В этом примере строка преобразуется в строчные регистры в формате fr-FR :

toUpper('Hello World', 'fr-FR')

И возвращается результат hello world.

toUpper

Возвращает строку в верхнем регистре в необязательном формате языкового стандарта. Если символ в строке не имеет версии в верхнем регистре, он добавляется в возвращаемую строку без изменений.

toUpper('<text>', '<locale>'?)

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка, возвращаемая в верхнем регистре
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<текст в верхнем регистре>	строка	Исходная строка в верхнем регистре

Пример 1

В этом примере строка преобразуется в верхний регистр.

toUpper('Hello World')

И возвращается результат HELLO WORLD.

Пример 2

В этом примере строка преобразуется в верхний регистр в формате fr-FR :

toUpper('Hello World', 'fr-FR')

И возвращается результат HELLO WORLD.

trim

Удаляет все начальные и конечные пробелы и возвращает обновленную строку.

trim('<text>')

Параметр	Обязательное поле	Type	Описание
<text>	Да	строка	Строка, которая содержит начальные и конечные пробелы для удаления

Возвращаемое значение	Тип	Описание
<обновленный текст>	строка	Обновленная версия исходной строки без начальных и конечных пробелов

Пример

В этом примере удаляются начальные и конечные пробелы из строки " Hello World ".

trim(' Hello World  ')

И возвращается сокращенный результат Hello World.

union

Возвращает коллекцию, которая содержит все элементы из указанных коллекций. Чтобы появиться в результатах, элемент должен содержаться в любой коллекции, переданной этой функции. Если один или несколько элементов имеют одинаковое имя, в результатах появляется последний элемент с таким именем.

union('<collection1>', '<collection2>', ...)
union([<collection1>], [<collection2>], ...)

Параметр	Обязательное поле	Type	Описание
<collection1>, <collection2>, ...	Да	Массив или объект, но не оба типа сразу.	Коллекции, из которых нужно получить элементы.

Возвращаемое значение	Тип	Описание
<обновленная коллекция>	Массив или объект соответственно.	Коллекция, которая содержит все элементы из указанных коллекций. Дубликаты не включаются.

Пример

В этом примере извлекаются все элементы из следующих коллекций:

union(createArray(1, 2, 3), createArray(1, 2, 10, 101))

И возвращается результат [1, 2, 3, 10, 101].

unique

Удаляет из массива все дубликаты.

unique([<collection>])

Параметр	Обязательное поле	Type	Описание
<collection>	Да	array	Коллекция для преобразования.

Возвращаемое значение	Тип	Описание
<new-collection>	array	Новая коллекция, из которой удалены все повторяющиеся элементы.

Пример 1

В этом примере удаляются повторяющиеся элементы из следующего массива:

unique(createArray(1, 2, 1))

И возвращается результат [1, 2].

uriComponent

Возвращает двоичную версию компонента URI.

uriComponent('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Строка для преобразования в формат закодированного URI

Возвращаемое значение	Тип	Описание
<закодированный URI>	строка	Строка с закодированным URI, содержащая escape-символы

Пример

В этом примере для строки создается версия с закодированным URI.

uriComponent('https://contoso.com')

И возвращается результат http%3A%2F%2Fcontoso.com.

uriComponentToString

Возвращает декодированную версию строки с закодированным URI.

uriComponentToString('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Декодируемая строка с закодированным URI

Возвращаемое значение	Тип	Описание
<двоичная версия закодированного URI>	строка	Декодированная версия строки с закодированным URI

Пример

В этом примере создается декодированная версия строки с закодированным URI.

uriComponentToString('http%3A%2F%2Fcontoso.com')

И возвращается результат https://contoso.com.

uriHost

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

uriHost('<uri>')

Параметр	Обязательное поле	Type	Описание
<uri>	Да	строка	URI, из которого нужно получить значение узла.

Возвращаемое значение	Тип	Описание
<значение узла>	строка	Значение узла из указанного URI.

Пример

В этом примере выполняется поиск значение узла из следующего значения URI.

uriHost('https://www.localhost.com:8080')

И возвращается результат www.localhost.com.

uriPath

Возвращает значение пути из значения URI.

uriPath('<uri>')

Параметр	Обязательное поле	Type	Описание
<uri>	Да	строка	URI, из которого нужно получить значение пути.

Возвращаемое значение	Тип	Описание
<значение пути>	строка	Значение пути из указанного URI.

Пример

В этом примере выполняется значения сегмента пути из следующего значения URI.

uriPath('http://www.contoso.com/catalog/shownew.htm?date=today')

И возвращается результат /catalog/shownew.htm.

uriPathAndQuery

Возвращает значение пути и запроса из значения URI.

uriPathAndQuery('<uri>')

Параметр	Обязательное поле	Type	Описание
<uri>	Да	строка	URI, из которого нужно получить значения пути и запроса.

Возвращаемое значение	Тип	Описание
<значение запроса пути>	строка	Значения пути и запроса из указанного URI.

Пример

В этом примере выполняется поиск значений пути и запроса из следующего значения URI.

uriPathAndQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

И возвращается результат /catalog/shownew.htm?date=today.

uriPort

Возвращает значение порта из значения URI.

uriPort('<uri>')

Параметр	Обязательное поле	Type	Описание
<uri>	Да	строка	URI, из которого нужно получить значение пути.

Возвращаемое значение	Тип	Описание
<значение порта>	строка	Значение порта из указанного URI.

Пример

В этом примере выполняется поиск значения порта из следующего значения URI.

uriPort('http://www.localhost:8080')

И возвращается результат 8080.

uriQuery

Возвращает значение запроса из значения URI.

uriQuery('<uri>')

Параметр	Обязательное поле	Type	Описание
<uri>	Да	строка	URI, из которого нужно получить значение запроса.

Возвращаемое значение	Тип	Описание
<значение запроса>	строка	Значение запроса из указанного URI.

Пример

В этом примере выполняется поиск значения запроса из следующего значения URI.

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

И возвращается результат ?date=today.

uriScheme

Возвращает значение схемы из значения URI.

uriScheme('<uri>')

Параметр	Обязательное поле	Type	Описание
<uri>	Да	строка	URI, из которого нужно получить значение запроса.

Возвращаемое значение	Тип	Описание
<значение схемы>	строка	Значение схемы из указанного URI.

Пример

В этом примере выполняется поиск значения схемы из следующего значения URI.

uriQuery('http://www.contoso.com/catalog/shownew.htm?date=today')

И возвращается результат http.

utcNow

Возвращает текущую метку времени в необязательном формате языкового стандарта в виде строки.

utcNow('<format>', '<locale>'?)

Кроме того, можно указать другой формат с помощью параметра <format>.

Параметр	Обязательное поле	Type	Описание
<format>	Нет	строка	Пользовательский шаблон формата. По умолчанию для метки времени используется формат UTC ISO (YYYY-MM-DDTHH:mm:ss.fffZ), который соответствует стандарту ISO 8601.
<локаль>	Нет	строка	Необязательный языковой стандарт сведений о языке и региональных параметрах

Возвращаемое значение	Тип	Описание
<текущая метка времени>	строка	Текущая дата и время

Пример 1

Предположим, что текущая дата — 15 апреля 2018 года, а время — 13:00:00. В этом примере извлекается метка времени.

utcNow()

И возвращается результат 2018-04-15T13:00:00.000Z.

Пример 2

Предположим, что текущая дата — 15 апреля 2018 года, а время — 13:00:00. В этом примере извлекается текущая метка времени в альтернативном формате D.

utcNow('D')

И возвращается результат Sunday, April 15, 2018.

Пример 3

Предположим, что текущая дата — 15 апреля 2018 года, а время — 13:00:00. В этом примере возвращается текущая метка времени с помощью языкового стандарта de-DE :

utcNow('', 'de-DE')

И возвращает результат 15.04.18 13:00:00.

где

Применяет фильтр к каждому элементу и возвращает новую коллекцию тех элементов, которые соответствуют указанному условию.

where([<collection/instance>], <iteratorName>, <function>)

Параметр	Обязательное поле	Type	Описание
<collection/instance>	Да	array	Коллекция с элементами.
<iteratorName>	Да	Имя итератора.	Ключевой элемент
<function>	Да	выражение	Функция условия, которая применяется для фильтрации элементов.

Возвращаемое значение	Тип	Описание
<new-collection/new-object>	Массив или объект.	Новая коллекция, в которой к каждому элементу применен фильтр, заданный функцией.

Пример 1

В этом примере создается новая коллекция.

where(createArray(0, 1, 2, 3), x, x > 1)

И возвращается результат [2, 3].

Пример 2

В этих примерах создается новая коллекция:

where(json("{'name': 'jack', 'age': '15'}"), x, x.value == 'jack')
where(json("{'name': 'jack', 'age': '15'}"), x=> x.value == 'jack')

И возвращает результат ['name:jack', 'age:15']. Обратите внимание, что второе выражение является лямбда-выражением, которое некоторые находят более удобочитаемым.

xml

Возвращает строку, которая содержит объект JSON, в формате XML.

xml('<value>')

Параметр	Обязательное поле	Type	Описание
<значение>	Да	строка	Строка с объектом JSON для преобразования. Объект JSON должен содержать только одно корневое свойство, которое не может быть массивом. Используйте escape-символ \ для двойных кавычек (").

Возвращаемое значение	Тип	Описание
<версия XML>	объект	Закодированный XML для заданной строки или объекта JSON

Пример 1

В этом примере создается версия XML для строки, которая содержит объект JSON.

xml(json('{ \"name\": \"Sophia Owen\" }'))

И возвращается полученный текст XML.

<name>Sophia Owen</name>

Пример 2

Предположим, что у вас есть представленный ниже объект JSON person.

{
  "person": {
    "name": "Sophia Owen",
    "city": "Seattle"
  }
}

В этом примере создается строка XML, содержащая этот объект JSON.

xml(json('{\"person\": {\"name\": \"Sophia Owen\", \"city\": \"Seattle\"}}'))

И возвращается полученный текст XML.

<person>
  <name>Sophia Owen</name>
  <city>Seattle</city>
<person

xPath

Проверяет XML на наличие узлов или значений, которые соответствуют выражению XPath, и возвращает соответствующие узлы или значения. Выражение XPath (или просто XPath) помогает перемещаться по структуре документа XML, чтобы вы могли выбирать узлы или вычислять значения в содержимом XML.

xPath('<xml>', '<xpath>')

Параметр	Обязательное поле	Type	Описание
<xml>	Да	любое	Строка XML для поиска узлов и значений, которые соответствуют значению выражения XPath
<xPath>	Да	любое	Выражение XPath, используемое для поиска соответствующих узлов или значений XML

Возвращаемое значение	Тип	Описание
<узел XML>	XML	Узел XML, где только один узел соответствует указанному выражению XPath
<значение>	любое	Значение из узла XML, где только одно значение соответствует указанному выражению XPath
<[<xml-node1, <xml-node2>, ...] -or- [<value1>>, <value2>, ...]>	array	Массив с узлами XML или значениями, которые соответствуют указанному выражению XPath

Пример 1

В этом примере выполняется поиск узлов, которые соответствуют узлу <name></name> ​​в указанных аргументах, и возвращается массив с этими значениями узлов:

xPath(items, '/produce/item/name')

Аргументы содержат строки items с таким кодом XML:

"<?xml version="1.0"?> <produce> <item> <name>Gala</name> <type>apple</type> <count>20</count> </item> <item> <name>Honeycrisp</name> <type>apple</type> <count>10</count> </item> </produce>"

Ниже приведен результирующий массив с узлами, которые соответствуют условию <name></name>.

[ <name>Gala</name>, <name>Honeycrisp</name> ]

Пример 2

В следующем примере 1 выполняется поиск узлов, которые соответствуют условию <count></count>, затем значения этих узлов суммируются с помощью функции sum().

xPath(xml(parameters('items')), 'sum(/produce/item/count)')

И возвращается результат 30.

год

Возвращает год из указанной метки времени.

year('<timestamp>')

Параметр	Обязательное поле	Type	Описание
<timestamp>	Да	строка	Строка, содержащая метку времени

Возвращаемое значение	Тип	Описание
<year>	integer	Значение года из указанной метки времени.

Пример

В этом примере оценивается значение года в метке времени.

year('2018-03-15T00:00:00.000Z')

И возвращается результат 2018.