オートメーションエディタ内の表現の完全なリスト

この記事には、Automations Editor のロジックブロック内で使用可能な式の完全なリストが記載されています。

式を使用することで、データをさまざまな方法で活用したり、異なる形式に変換したりすることができます。

オートメーションエディタでの式

すべての例は、Automation の入力、出力、および変数に基づいています。

ADD_TIME()：Datetime値に、指定された量と間隔単位を加算します。

例：ADD_TIME(*datetime_variable,*2, 'years')

SUBTRACT_TIME()：Datetime 値を、指定された量と間隔単位だけ減算します。

例：SUBTRACT_TIME(*datetime_variable,*3, 'months')

型変換式

DATETIMETOTEXT()
Datetime 値を、人間が読みやすいテキスト値に変換します。

例：DATETIMETOTEXT(datetime_variable, "MMMM DD, YYYY", 'America/New_York')

これにより、日付時刻が東部標準時（EST）に変換され、「2019年1月1日」のような従来の日付形式で表示されます。

**注：**最後のパラメータであるタイムゾーンは、ここにリストされているtz データベース名のいずれかである必要があります。

FILETOTEXT("url: File") => Text ファイルを URL のテキスト文字列に変換します

例：FILETOTEXT("http://www.africau.edu/images/default/sample.pdf")

HEX_TO_INT()
指定された 16 進数文字列の数値表現を返します。
例：HEX_TO_INT('0xAB18') = '43800'

INT_TO_HEX()
指定された数値の 16 進数表現を返します。
例：INT_TO_HEX('43800') = '0xAB18'

INTERVAL_TO_SECONDS(interval: Interval) => Number 指定された Interval の長さを秒単位で返します。

例：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_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()**秒を 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 に変換します。

例：TEXTTOIMAGEURL("https://example.com/photo.jpg")

**TEXTTOINTEGER()**テキストまたは区間を整数として解析します。

例：TEXTTOINTEGER("123")

**TEXTTONUMBER()**テキストまたはタイムスタンプを数値として解析します。

例：TEXTTONUMBER("2.4")

TOTEXT()：任意の値をテキストに変換します。

例：TOTEXT(2)

UPPERCASE()
文字列をすべて大文字に変換します

切り捨てられた式

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 が東部標準時（EST）の月のみに変換されます。

**注：**最後のパラメータであるタイムゾーンは、ここにリストされているtz データベース名のいずれかである必要があります。

値を返す式

ABS()
数値の絶対値を返します。

CONTAINS()
文字列に指定された部分文字列が含まれているかどうかを返します
例：CONTAINS("123ABC", "123")
この場合、「true」が返されます

COS()
指定された入力のコサインを返します

ENCODE_URI(component: Text) => Text
URI を URL エンコードされた文字列として返します。
例：ENCODE_URI("http://example.com/a=foo&b=atest") = "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()**2番目の引数の中で、1番目の引数が現れる位置を返します。

IF()
第 1 引数に基づいて、第 1 引数が真の場合は第 2 引数を、第 1 引数が偽の場合は第 3 引数を返します。
例：IF(true, 1, 2)

**ISNULL()**引数が NULL の場合は true を返し、それ以外の場合は false を返します。

LEFT()：2番目の引数で指定された位置から始まる、テキスト値の部分文字列を返します。

**LEN()**テキスト値の長さを返します。また、配列内の要素数も返します。

LINK()
引数のうち、NULLでない最初の値を返します。

例：LINK(weight, 70)
weight に値が設定されている場合、weightの値を返します。

MAX()
値が最も大きい引数を返します。
例：MAX(var1, var2)
var1 の値が var2 の値より大きい場合、var1 の値を返します。

MID()：2番目の引数で指定された位置から始まる、テキスト値の部分文字列を返します。3番目の引数で、返す文字列の長さを指定します。

**MIN()**値が最も小さい引数を返します
例：MIN(var1, var2)
var1の値がvar2の値より小さい場合、var1の値を返します

POW()
第1引数を第2引数乗した値を返します。
例：POW(3,2)
これにより、9が返されます

RAND()
0 から 1 までの間のランダムな小数を生成します

RANDBETWEEN()
指定された2つの数値の範囲内の整数を生成します
例：RANDBETWEEN(5,10)

RANDOMSTRING()
17文字のランダムな文字列を返します。新しいテーブルレコードのIDを作成するために使用されます。

**RANDOM_COLOR()**ランダムな色を生成します

例：RANDOM_COLOR() = ##c537a5

RGA(r: 整数, g: 整数, b: 整数, a: 整数) => 色 指定された赤、緑、青、アルファ成分の色を返します

例：RGA(255, 255, 0, 0.5) = ##ffff00 (不透明度 50%)

RGB(r: 整数, g: 整数, b: 整数) => Color 指定された赤、緑、青の成分からなる色を返します

例：RGB(255, 255, 0) = ##ffff00

**RIGHT()**テキスト値のサブストリングを、2番目の引数で指定された位置で終了するように返します。

SIN()
指定された入力の正弦値を返します

**SPLIT()**テキスト値を、指定された区切り文字で配列に分割します。

SQRT()
数値の平方根を返します。

SUBSTITUTE()
第1引数で指定された文字列内で、第2引数のすべての出現箇所を第3引数に置き換えます
例：SUBSTITUTE("A734", "7", "3")
これにより「A334」が返されます

TAN()
指定された入力の正接を返します

**TRIM()**1 番目の引数の先頭と末尾から、2 番目の引数で指定された部分文字列を削除します。

配列式

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()**テキスト値に対する正規表現の一致結果を配列として返します。指定された正規表現と修飾子に基づいて一致を判定します。このメソッドはJavaScript の match メソッドに基づいており、2 つの「モード」があります。

このメソッドに2つの引数が指定された場合、以下のJavaScript式と同等になります：text.match(new RegExp(regex))オプションのパラメータ modifiers が指定された場合、このメソッドは JavaScript の次の式と同等になります：text.match(new RegExp(regex, modifiers))modifiers は、正規表現検索の動作を変更するために使用できるフラグです。

**REGEX_REPLACE()**テキスト値の正規表現一致結果の配列を返します。指定された正規表現と修飾子に基づいて一致を判定します。このメソッドは、JavaScript の replace メソッドに基づいています。

この関数に 3 つの引数が指定された場合、これは JavaScript の次の式と同等になります：text.replace(new RegExp(regex), replacement)

オプションのパラメータ modifiers が指定された場合、このメソッドは JavaScript の次の式と同等になります：text.replace(new RegExp(regex, modifiers), replacement)修飾子（modifiers）は、正規表現検索の挙動を変更するために使用できるフラグです。

文字列内で正規表現を記述する場合、JavaScript では文字列リテラル内の各バックスラッシュをエスケープ文字として扱うため、バックスラッシュ () をエスケープする必要があります。

regex_replace('Hello There', '(\\w+)\\s(\\w+)', '$2 $1')この式は「There Hello」を出力します。