Выражения и функции

Примерные данные

Примеры на этой странице используют данные ниже; результат каждого выражения указан после =>

{
  "first_name": "John",
  "last_name": "Smith",
  "birth_year": "1977",
  "yob": 2012,
  "mortgage_amount": 65000,
  "debt_amount": 8283.25,
  "started_at_utc": "2020-06-21 22:35:12 UTC"
}

Выражение String

Аргументы обрабатываются как текст перед выполнением выражения.

[!String! ALPHANUMERIC_DASH(CONCAT([first_name], " ", [last_name])) !!]
=> john-smith

Выражение Time

Аргументы обрабатываются как время перед выполнением выражения.

[!Time! DATE_FORMAT(DATE_ADD([started_at_utc], 86400), "%Y-%m-%d %M-%S") !!]
=> "2020-06-22T18:35:12"

case(statement)

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

CASE('apple' WHEN 'apple' THEN 1 WHEN 'banana' THEN 2 ELSE 3 END)
=> 1

if(statement, output_when_true, output_when_false)

Проверяет условие и возвращает одно значение, если оно выполняется, и другое — если нет.

IF(15 < 10, 10, 20)
=> 20

avg(*values)

Среднее переданных чисел.

AVG(1,2,3,4)
=> 2.5

count(*values)

Сколько значений передано.

COUNT(1,2,3,4)
=> 4

max(*values)

Наибольшее из переданных чисел.

MAX(1,2,3,4)
=> 4

min(*values)

Наименьшее из переданных чисел.

MIN(1,2,3,4)
=> 1

round(value, precision)

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

ROUND(8.2)
=> 8

rounddown(value, precision)

Округляет число вниз, к меньшему значению, с заданной точностью.

ROUNDDOWN(1.234)
=> 1

roundup(value, precision)

Округляет число вверх, к большему значению, с заданной точностью.

ROUNDUP(1.234)
=> 2

sum(*values)

Складывает переданные числа.

SUM(1,2,3,4)
=> 10

alphanumeric_dash(value)

Оставляет только буквы (a-z, A-Z) и цифры (0-9), заменяет пробелы дефисами и обрезает пробелы с обоих концов. Удобно для слагов и ID.

ALPHANUMERIC_DASH(" ./;!!!]  hello waffle world!@#$%^&*($)  ")
=> "hello-waffle-world"

alphanumeric_underscore(value)

Оставляет только буквы (a-z, A-Z) и цифры (0-9), заменяет пробелы подчёркиваниями и обрезает пробелы с обоих концов.

ALPHANUMERIC_UNDERSCORE(" ./;!!!]  hello waffle world!@#$%^&*($)  ")
=> "hello_waffle_world"

base64_decode(value)

Декодирует строку Base64 (RFC 2045), пропуская символы вне алфавита Base64.

BASE64_DECODE('dGVzdA==')
=> 'text'

base64_encode(value)

Кодирует значение в Base64 (RFC 2045) с переводом строки после каждых 60 закодированных символов.

BASE64_ENCODE('text')
=> 'dGVzdA=='

concat(*values)

CONCAT('AB', 'CD', 'EF')
=> "ABCDEF"

contains(search, value)

CONTAINS('ABCD', 'A')
=> true

date_add(value, seconds)

Сдвигает дату вперёд на заданное число секунд.

DATE_ADD([started_at_utc], 86400)
=> "2020-06-29 11:34:25 -0400"

date_format(value, format)

Записывает дату в выбранном формате.

DATE_FORMAT([started_at_utc], "%Y-%m-%d %M-%S")
=> "2020-06-22T18:35:12"

date_parse(value, format)

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

DATE_PARSE("30 days from now")
=> "2020-07-29 15:42:57 UTC"

date_subtract(time, time_or_decimal)

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

DATE_SUBTRACT([current_time_utc], [started_at_utc])
=> "2020-06-29 11:34:25 -0400"

date_to_time_zone(value, time_zone)

Переводит дату в другой часовой пояс.

DATE_TO_TIME_ZONE([lead_created_at], "Eastern Time (US & Canada)")
=> "2020-07-29 15:42:57"

digest_md5(value)

Возвращает MD5-хеш значения (RFC 1321): 128-битный (16-байтный) дайджест.

DIGEST_MD5('text')
=> 90015098...

digest_sha1(value)

Возвращает SHA-1-хеш значения, как определено NIST в FIPS PUB 180-1.

DIGEST_SHA1('text')
=> a9993e36...

digest_sha2(value)

Возвращает SHA-256-хеш значения: 256-битный дайджест, вычисленный по 512-битным блокам.

DIGEST_SHA2('text')
=> ba7816bf8...

downcase(value)

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

DOWNCASE("HELLO World")
=> "hello world"

find(search, value)

FIND('BC', 'ABCD')
=> 2

generate_uuid()

Создаёт новый универсальный уникальный идентификатор (UUID).

GENERATE_UUID()
=> "518e8221-a29e-72c1-a716-486156481234"

left(value, length)

LEFT('ABCD', 2)
=> "AB"

len(value, length)

LEN('ABCD')
=> 4

oauth_access_token(oauth_connection_key)

Получает токен доступа из одного из ваших OAuth-подключений для аутентифицированных вебхуков.

OAUTH_ACCESS_TOKEN('marchex_v2')
=> "sdjf9032fj239fj90sjf90wjf390"

right(value, length)

RIGHT('ABCD', 2)
=> "CD"

seconds_to_hms(seconds)

Показывает число секунд как ЧЧ:ММ:СС, например длительность звонка.

SECONDS_TO_HMS(3672)
=> "01:01:12"

split(value, pattern, index)

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

SPLIT("John Smith", " ", 1)
=> "Smith"

strip(value)

Обрезает пробельные символы в начале и конце значения.

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

STRIP("    hello world   ")
=> "hello world"

substitute(value, search, replacement)

SUBSTITUTE('green cat, blue cat, yellow cat', 'cat', 'dog')
=> "green dog, blue cat, yellow cat"

substitute_all(value, search, replacement)

Заменяет все вхождения одного фрагмента текста другим.

SUBSTITUTE_ALL("green cat, blue cat, yellow cat", "cat", "dog")
=> "green dog, blue dog, yellow dog"

substring(value, start, length)

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

SUBSTRING([started_at_offer_time_zone], 0, 9)
=> "2020-09-20"

titleize(value)

Делает первую букву каждого слова заглавной.

TITLEIZE("  hello world  ")
=> "  Hello World  "

to_currency(value, symbol)

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

TO_CURRENCY("1234567.89")
=> "$1,234,567.89"

TO_CURRENCY("1234567.89", "€")
=> "€1,234,567.89"

to_formatted_number(args, **, block)

Форматирует номер телефона так, как он записывается в стране.

TO_FORMATTED_NUMBER(" + 1 719-852-2985 ")
=> "(719) 522-0377"

to_integer(value)

Превращает значение в целое число.

TO_INTEGER(' 15.15 ')
=> 15

to_json(value)

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

TO_JSON({example: "value"})
=> {"example": "value"}

to_phone_number(value)

Нормализует номер телефона в международный формат.

TO_PHONE_NUMBER(" 1 (719) 852 2985 ")
=> "+17198522985"

upcase(value)

Делает все буквы заглавными.

UPCASE("Hello World")
=> "HELLO WORLD"

url_decode(value)

Превращает последовательности процентного кодирования (% и две шестнадцатеричные цифры) обратно в символы, которые они обозначают.

URL_DECODE("hello%20world%2C%20how%20are%20you%3F")
=> "hello world, how are you?"

url_encode(value)

Кодирует процентами все символы, кроме букв и цифр, чтобы значение было безопасно в URL.

URL_ENCODE("hello world, how are you?")
=> "hello%20world%2C%20how%20are%20you%3F"

usa_zip_code(value)

Оставляет только первые пять цифр, превращая ZIP+4 в стандартный почтовый индекс США.

USA_ZIP_CODE("USA 90210 OR")
=> "90210"