式と関数

サンプルデータ

このページの例は以下のデータを使用しています。各式の結果は => の後に示しています

{
  "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)

NIST が FIPS PUB 180-1 で定義した、値の SHA-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)

認証付き Webhook のために、OAuth 接続の 1 つからアクセストークンを取得します。

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)

パーセントエンコードされたシーケンス（% の後に 16 進数 2 桁）を、元の文字に戻します。

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)

最初の 5 桁だけを残し、ZIP+4 を標準的な米国の郵便番号にします。

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