Стандартные функции адаптивных выражений
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ 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
В этом примере принимается byteArr
new 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
Возвращает год из указанной метки времени.
year('<timestamp>')
Параметр | Обязательное поле | Type | Описание |
---|---|---|---|
<timestamp> | Да | строка | Строка, содержащая метку времени |
Возвращаемое значение | Тип | Описание |
---|---|---|
<year> | integer | Значение года из указанной метки времени. |
Пример
В этом примере оценивается значение года в метке времени.
year('2018-03-15T00:00:00.000Z')
И возвращается результат 2018.