表达式与函数

示例数据

本页示例使用以下数据；每个表达式的结果写在 => 之后

{
  "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)，把空格变为短横线并去除两端空格。适合生成 slug 和 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 哈希：按 512 位块计算的 256 位摘要。

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 连接获取访问令牌，用于需认证的 Webhook。

OAUTH_ACCESS_TOKEN('marchex_v2')
=> "sdjf9032fj239fj90sjf90wjf390"

right(value, length)

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

seconds_to_hms(seconds)

把秒数显示为 HH:MM:SS，例如通话时长。

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"