В этой статье приведён полный список выражений, доступных для использования в редакторе приложений в Trigger.
Использование выражений позволяет вам использовать данные различными способами или преобразовывать их в разные формы.
Available expressions differ between features (e.g. App Editor, Analytics Editor, Automations/Functions Editor).
To understand where each expression is available, see the full list of expressions in Tulip.
Выражения в редакторе приложений
Все примеры основаны на завершениях приложения. Таким образом, когда вы используете, например, функцию MAXIMUM() или MINIMUM(), вы ищете максимальное или минимальное значение переменной во всех завершениях приложения.
**ADD_TIME()**Увеличивает значение даты и времени на указанное количество и с заданной единицей интервала.
Пример: ADD_TIME(datetime_variable, 2, 'years')
**SUBTRACT_TIME()**Уменьшает значение даты и времени на указанное количество и с заданной единицей интервала.
Пример: SUBTRACT_TIME(datetime_variable, 3, 'months')
Выражения с приведением типов
**BADGE_ID_TO_USER()**Преобразует идентификатор бейджа в объект «Пользователь»
Пример: BADGE_ID_TO_USER(0000) = "John Doe" в виде объекта пользователя
DATETIMETOTEXT()
Преобразует значение даты и времени в текстовое значение, удобное для чтения человеком
Пример: DATETIMETOTEXT(datetime_variable, "MMMM DD, YYYY", 'America/New_York')
Это преобразует дату и время в Восточное стандартное время и отобразит их в традиционном формате даты, например «1 января 2019».
Примечание: последний параметр — часовой пояс — должен соответствовать одному из имен баз данных tz, перечисленных здесь.
FILETOTEXT("url: File") => Text Преобразует файл в текстовую строку в формате URL
Пример: FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")
HEX_TO_INT()
Возвращает числовое представление заданной шестнадцатеричной строки.
Пример: HEX_TO_INT('0xAB18') = '43800'
INT_TO_HEX()
Возвращает шестнадцатеричное представление заданного числа.
Пример: INT_TO_HEX('43800') = '0xAB18'
INTERVAL_TO_SECONDS(interval: Interval) => Number Возвращает длину интервала в секундах
Пример: 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 с указанными параметрами. Часто используется, если у вас есть URL-адрес изображения ( Connector Function ), содержащий дату и время в текстовом формате, и вам необходимо его преобразовать.
TEXTTOIMAGEURL(url:Text) => URL изображения Преобразует строку в URL изображения.
Пример: TEXTTOIMAGEURL("https://example.com/photo.jpg")
**TEXTTOINTEGER()**Преобразует текст или интервал в целое число.
Пример: TEXTTOINTEGER("123")
**TEXTTONUMBER()**Преобразует текст или временную метку в число
Пример: TEXTTONUMBER("2.4")
**TOTEXT()**Преобразует любой текст в текстовый формат.
Пример: TOTEXT(2)
UPPERCASE()
Преобразует строку в регистр заглавных букв
USER_ID_TO_USER(id: Text) => User Преобразует идентификатор пользователя в объект пользователя
Пример: User_id_to_user("abc") = User
Усеченные выражения
CEIL()
Округляет в большую сторону до ближайшего целого числа
FLOOR()
Округляет в меньшую сторону до ближайшего целого числа
ROUND()
Округляет число до указанного количества знаков после запятой. Максимум — 3 знака после запятой.
Пример 1 — ROUND(123,123456; 1)
В результате будет возвращено 123,1
Пример 2 — ROUND(123,12)
В результате будет возвращено 123
ROUNDDATETIME()
Округляет значение даты и времени до заданной единицы измерения, например до месяца или дня.
Пример: ROUNDDATETIME(datetime_variable, "Month", "America/New_York")
В результате дата и время будут преобразованы в значение, представляющее только месяц, в формате Восточного стандартного времени.
Примечание: последний параметр — часовой пояс — должен соответствовать одному из имен баз данных tz, перечисленных здесь.
Выражения, возвращающие значение
ABS()
Возвращает абсолютное значение числа
CONTAINS()
Возвращает, содержит ли строка заданную подстроку
Пример: 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 test"
ENCODE_URI_COMPONENT(component: Text) => Text
Возвращает строковую версию компонента URI, закодированную в формате URL.
Пример: ENCODE_URI_COMPONENT("a & b") = "a%20%26%20b"
**FIND()**Возвращает позицию, на которой первый аргумент встречается во втором аргументе.
IF()
На основании первого аргумента возвращает второй аргумент, если первый аргумент истинный, или третий аргумент, если первый аргумент ложный.
Пример: IF(true, 1, 2)
**ISNULL()**Возвращает true, если аргумент равен null, в противном случае — false.
**LEFT()**Возвращает подстроку текстового значения, начиная с позиции, указанной вторым аргументом.
**LEN()**Возвращает длину текстового значения. Также возвращает количество элементов в массиве.
LINK()
Возвращает первый из аргументов, который не равен null.
Пример: LINK(weight, 70)
В этом случае будет возвращено значение weight, если weight имеет значение
MAX()
Возвращает аргумент с наибольшим значением
Пример: MAX(var1, var2)
В этом случае будет возвращено значение var1, если оно больше значения var2
**MID()**Возвращает подстроку текстового значения, начиная с позиции, указанной вторым аргументом. Третий аргумент указывает длину возвращаемой подстроки.
**MIN()**Возвращает аргумент с наименьшим значением
Пример: MIN(var1, var2)
В этом случае будет возвращено значение var1, если оно меньше значения var2
POW()
Возвращает первый аргумент, возведённый в степень, указанную вторым аргументом
Пример: POW(3, 2)
В результате будет возвращено 9
RAND()
Генерирует случайное десятичное число в диапазоне от 0 до 1
RANDBETWEEN()
Генерирует случайное целое число в диапазоне между двумя указанными числами
Пример: RANDBETWEEN(5,10)
RANDOMSTRING()
Возвращает случайную строку длиной 17 символов. Предназначена для создания идентификатора новой записи в таблице.
**RANDOM_COLOR()**Генерирует случайный цвет
Пример: RANDOM_COLOR() = ##c537a5
RGBA(r: целое число, g: целое число, b: целое число, a: целое число) => Цвет. Возвращает цвет с указанными компонентами красного, зелёного, синего и альфа-канала
Пример: RGBA(255, 255, 0, 0,5) = ##ffff00 (прозрачность 50 %)
RGB(r: целое число, g: целое число, b: целое число) => Цвет. Возвращает цвет с указанными компонентами красного, зелёного и синего
Пример: 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_INDEX_OF()**Возвращает индекс первого вхождения заданного значения в указанном массиве. Если значение не найдено, возвращается «-1». Пример: ARRAY_INDEX_OF([1,2,3], 2). В результате будет возвращено 1
ARRAY_MAX()
Возвращает минимальное значение из заданного массива
Пример: ARRAY_MAX([1,2,3])
В этом случае будет возвращено 3
ARRAY_MIN()
Возвращает наименьшее значение из заданного массива
Пример: ARRAY_MIN([1,2,3])
В результате будет возвращено 1
ARRAY_STDEV_POPULATION()
Возвращает стандартное отклонение генеральной совокупности заданного числового массива
Пример: ARRAY_STDEV_POPULATION([1,2,3])
В результате будет возвращено 0,816496580927726
ARRAY_STDEV_SAMPLE()
Возвращает стандартное отклонение выборки заданного числового массива
Пример: ARRAY_STDEV_SAMPLE([1,2,3])
В результате будет возвращено 1
**ARRAY_VALUE_AT_INDEX()**Возвращает значение по заданному индексу в заданном списке. Если индекс выходит за пределы диапазона, возвращается null. Пример: ARRAY_VALUE_AT_INDEX([1,2,3], 0). В этом случае будет возвращено 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). Модификаторы — это флаги, которые можно использовать для изменения поведения поиска по регулярному выражению.
При написании регулярного выражения внутри строки необходимо экранировать обратные косые черты (), поскольку JavaScript рассматривает каждую обратную косую черту как экранирующий символ в строковых литералах.
regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')Это выражение выдаст «There Hello».
{{snippet.Нашли ли вы то, что искали?}}

