Полный список выражений в редакторе приложений

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

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

:::(Info) (ПРИМЕЧАНИЕ) Список выражений в App Editor отличается от выражений, доступных в Analytics Editor. :::

Доступные выражения в редакторе приложений

Все примеры основаны на приложениях Completions. Поэтому, например, когда вы используете функцию MAXIMUM() или MINIMUM(), вы ищете максимальное или минимальное значение переменной во всех завершениях приложения.

**ADD_TIME()**Увеличивает значение даты на указанную величину и единицу интервала.

Например. ADD_TIME*(datetime_variable,* 2, 'years')

**SUBTRACT_TIME()**Уменьшает значение Datetime на указанную сумму и единицу интервала.

Например. SUBTRACT_TIME*(datetime_variable,* 3, 'months')

Типовые выражения

DATETIMETOTEXT()

Преобразует значение Datetime в текстовое значение, которое легко читается человеком.

Например. DATETIMETOTEXT*(datetime_variable*, "MMMM DD, YYYY", 'America/New_York')

Это преобразует время даты в восточное стандартное время и покажет его в традиционном форматировании даты, например "1 января 2019 года".

Примечание: Последний параметр, часовой пояс, должен быть из одной из баз данных tz, перечисленных здесь.

FILETOTEXT("url: File") => Текст Преобразует файл в текстовую строку URL.

Например: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")

HEX_TO_INT()

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

Ex. HEX_TO_INT('0xAB18') = '43800'

INT_TO_HEX()

Возвращает шестнадцатеричное представление заданного числа.

Ex. INT_TO_HEX('43800') = '0xAB18'

INTERVAL_TO_SECONDS(interval: Interval) => Number Возвращает длину интервала в секундах.

EX. INTERVAL_TO_SECONDS(seconds_to_interval(30.0))

LOWERCASE()

Преобразовывает строку во все строчные буквы

MAP_TO_BOOLEAN_LIST*(a:* {} array, b: text) => array Преобразует массив объектов в базовый массив для заданного ключа

Например. MAP_TO_BOOLEAN_LIST([{key: value}], 'key') = [value]

MAP_TO_INTEGER_LIST*(a:* {} array, b: text) => array Преобразует объектный массив в базовый массив для заданного ключа

Например. MAP_TO_INTEGER_LIST([{key: value}], 'key') = [value]

MAP_TO_NUMBER_LIST*(a:* {} array, b: text) => array Преобразует объектный массив в базовый массив для заданного ключа

Например. MAP_TO_NUMBER_LIST([{key: value}], 'key') = [value]

MAP_TO_TEXT_LIST*(a:* {} array, b: text) => array Преобразует объектный массив в базовый массив для заданного ключа

Например. MAP_TO_TEXT_LIST([{key: value}], 'key') = [value]

**SECONDS_TO_INTERVAL()**Преобразует секунды в интервал.

SECONDS_TO_INTERVAL(seconds: Integer или Number) => Interval

Например. SECONDS_TO_INTERVAL(20) => 0:00:20

**TEXTTOBOOLEAN()**Разбирает текст на булевы числа.

"y", "yes", "t", "true", "on" и любые варианты с заглавной буквы распознаются как true, а "n", "no", "f" "false" и "off" - как false.

Например. TEXTTOBOOLEAN("yes")

TEXTTODATETIME()

Преобразует текстовое значение в значение Datetime с указанными параметрами. Обычно используется, если у вас есть функция-коннектор, которая передает Datetime в текстовом формате, и вам нужно его преобразовать.

TEXTTOIMAGEURL(url:Text) => URL изображения Преобразует строку в URL изображения.

EX. TEXTTOIMAGEURL("https://example.com/photo.jpg")

**TEXTTOINTEGER()**Разбирает текст или интервал в целое число.

Например. TEXTTOINTEGER("123")

**TEXTTONUMBER()**Разбирает текст или временную метку в число.

Например. TEXTTONUMBER("2.4")

**TOTEXT()**Разбирает любой текст в текст.

Например. TOTEXT(2)

UPPERCASE()

Преобразует строку в верхний регистр.

USER_ID_TO_USER(id: Text) => User Преобразует идентификатор пользователя в объект пользователя.

Ex. User_id_to_user("abc") = User

Усеченные выражения

CEIL()

Округляет до ближайшего целого числа

FLOOR()

Округляет вниз до ближайшего целого числа

ROUND()

Округляет число до указанного количества знаков после запятой. Максимум 3 знака после запятой.

Например. 1 - ROUND(123.123456, 1)

Вернется 123.1

Пример 2 - ROUND(123.12)

Вернется 123

ROUNDDATETIME()

Усекает значение Datetime до заданной единицы измерения, например месяца или дня.

Ex. ROUNDDATETIME*(datetime_variable*, "Month", "America/New_York")

Это преобразует значение datetime только в месяц по восточному стандартному времени.

Примечание: Последний параметр, часовой пояс, должен быть из одного из имен баз данных tz, перечисленных здесь.

Выражения для возврата значений

ABS()

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

CONTAINS()

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

Ex. CONTAINS("123ABC", "123")

Возвращает "true".

COS()

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

ENCODE_URI(component: Text) => Text

Возвращает URL-кодированную строковую версию URI.

Например. ENCODE_URI("http://example.com/a=foo&b=a test") ="http://example.com/a=foo&b=a%20test".

ENCODE_URI_COMPONENT(компонент: Текст) => Текст

Возвращает URL-кодированную строковую версию компонента URI.

EX. ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b".

**FIND()**Возвращает позицию, в которой первый аргумент встречается внутри второго аргумента.

IF()

На основе первого аргумента возвращает второй аргумент, если первый аргумент истинен, или третий аргумент, если первый аргумент ложен.

Например. IF(true, 1, 2)

**ISNULL()**Возвращает true, если аргумент равен null, иначе false.

**LEFT()**Возвращает подстроку текстового значения, начинающуюся с позиции, указанной вторым аргументом.

**LEN()**Возвращает длину текстового значения.

LINK()

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

Например. LINK(weight, 70)

Вернет значение weight, если weight имеет значение

MAX()

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

Ex. MAX(var1, var2)

Вернет значение var1, если оно больше значения var2

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

**MIN()**Возвращает аргумент с наименьшим значением.

Ex. MIN(var1, var2)

Вернет значение var1, если оно меньше значения var2.

POW()

Возвращает первый аргумент, возведенный в степень второго аргумента

Ex. POW(3,2)

Вернет 9

RAND()

Генерирует случайное десятичное число между 0 и 1

RANDBETWEEN()

Генерирует случайное целое число между двумя указанными числами.

Например. RANDBETWEEN(5,10)

RANDOMSTRING()

Возвращает случайную 17-символьную строку. Предназначена для создания идентификатора новой записи в таблице.

**RANDOM_COLOR()**Генерирует случайный цвет.

Ex. RANDOM_COLOR() = ##c537a5

RGA(r: Integer, g:Integer, b:Integer, a:Integer) => Color Возвращает цвет из указанных красной, зеленой, синей и альфа-компоненты.

Ex. RGA(255, 255, 0, 0.5) = ##ffff00 (50 % непрозрачности)

RGB(r: Integer, g:Integer, b:Integer) => Color Возвращает цвет из указанных красной, зеленой и синей компонент.

Ex. RGB(255, 255, 0) = ##ffff00

**RIGHT()**Возвращает подстроку текстового значения, заканчивающуюся на позиции, указанной вторым аргументом.

SIN()

Возвращает синус заданного входного значения.

**SPLIT()**Разделяет текстовое значение на массив по заданному разделителю.

SQRT()

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

SUBSTITUTE()

В строке, заданной первым аргументом, заменить все примеры второго аргумента на третий аргумент

Например. SUBSTITUTE("A734", "7", "3")

Вернется значение "A334".

TAN()

Возвращает тангенс заданного входного значения

**TRIM()**Удаляет подстроку (заданную вторым аргументом) из передней и задней частей первого аргумента.

Выражения массивов

ARRAY_AVG()

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

Например. ARRAY_AVG([1,2,3])

Вернет 2

ARRAY_CONCAT()

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

Например. ARRAY_CONCAT([1,2],[3,4],[5,6])

Это вернет [1,2,3,4,5,6].

ARRAYCONTAINS()

Определить, находится ли значение в массиве.

Например. ARRAYCONTAINS([1,2,3], 1)

Вернет значение "true"

ARRAY_MAX()

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

Например. ARRAY_MAX([1,2,3])

Вернет 3

ARRAY_MIN()

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

Например. ARRAY_MIN([1,2,3])

Вернет 1

ARRAY_STDEV_POPULATION()

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

Ex. ARRAY_STDEV_POPULATION([1,2,3])

Это вернет 0,816496580927726

ARRAY_STDEV_SAMPLE()

Возвращает стандартное отклонение выборки данного числового массива

Ex. ARRAY_STDEV_SAMPLE([1,2,3])

Вернет 1

**REGEX_MATCH()**Возвращает массив совпадений регулярных выражений с текстовым значением. Совпадения основаны на заданном регулярном выражении и модификаторах. Этот метод основан на методе match JavaScript и имеет 2 "режима".

Если методу заданы 2 аргумента, он эквивалентен следующему выражению на JavaScript:text.match(new RegExp(regex))Если указан необязательный параметр modifiers, метод эквивалентен следующему выражению на JavaScript:text.match(new RegExp(regex, modifiers))Модификаторы - это флаги, которые могут быть использованы для изменения поведения регекс-поиска.

**REGEX_REPLACE()**Возвращает массив совпадений регулярного выражения с текстовым значением. Соответствия основаны на заданном регулярном выражении и модификаторах. Этот метод основан на методе replace JavaScript.

Если функции задано 3 аргумента, она эквивалентна следующему выражению JavaScript:text.replace(new RegExp(regex), replacement). Если задан необязательный параметр modifiers, метод эквивалентен следующему выражению JavaScript:text.replace(new RegExp(regex, modifiers), replacement)Модификаторы - это флаги, которые можно использовать для изменения поведения регекс-поиска.

Вы нашли то, что искали?

Вы также можете зайти на community.tulip.co, чтобы задать свой вопрос или узнать, сталкивались ли другие с подобным вопросом!