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

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

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

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

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

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

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

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

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

Например. 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()**Разбирает текст или временную метку в число.

Ex. 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 до заданной единицы измерения, например, месяца или дня.

Пример. ROUNDDATETIME*(datetime_variable*, "Month", "America/New_York")

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

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

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

ABS()

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

CONTAINS()

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

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

Возвращает значение "true"

COS()

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

ENCODE_URI(component: Text) => Text

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

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

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

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

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 Возвращает цвет из указанных красной, зеленой и синей компонент.

Например. 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()

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

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

Вернет 3

ARRAY_MIN()

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

Ex. 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()**Возвращает массив совпадений регулярных выражений с текстовым значением. Соответствия основаны на заданном регулярном выражении и модификаторах.

**REGEX_REPLACE()**Возвращает модифицированный массив со строковыми заменами, заданными в выражении.

Например. REGEX_REPLACE("BaNaNa", "N", "n", "g") = "Banana".

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

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