ドキュメントCampaignCampaign Standard ドキュメント

関数のリスト

最終更新日: 2024年7月19日
  • 適用対象:
  • Campaign Standard
  • トピック:

作成対象:

  • 経験者
  • 開発者

関数について

クエリ編集ツールを使用すると、高度な関数を使用して複雑なフィルタリングを実行できます。このために、ツールパレットにはワークスペースで使用できる​ Expression ​要素が含まれています。この要素について詳しくは、こちらの節を参照してください。

この要素では、条件を手動で入力できます。ここでは、以降の節で説明する関数を使用できます。

目的とする結果や操作するデータのタイプに応じて、次のいくつかの関数タイプを使用できます。

  • 日付
  • ジオマーケティング
  • 数値
  • その他の関数
  • 集計
  • 文字列操作
  • 並べ替え
メモ
外部パラメーターを使用してワークフローを呼び出した後にイベント変数を使用できる追加関数をすべてのアクティビティで使用できます。 詳しくは、この節を参照してください。

日付

日付関数は、日付や時刻の値を操作する場合に使用します。

名前説明構文
AddDays日付に日数を追加しますAddDays(<日付>, <数値>)
AddHours日付に時間数を追加しますAddHours(<日付>, <数値>)
AddMinutes日付に分数を追加しますAddMinutes(<日付>, <数値>)
AddMonths日付に月数を追加しますAddMonths(<日付>, <数値>)
AddSeconds日付に秒数を追加しますAddSeconds(<日付>, <数値>)
AddYears日付に年数を追加しますAddYears(<日付>, <数値>)
DateOnly日付のみを返します(時刻は 00:00)DateOnly(<日付>)
Day日付の日を表す数を返しますDay(<日付>)
DayOfYear日付の年を表す数を返しますDayOfYear(<日付>)
DaysAgo現在の日付 - n 日を返しますDaysAgo(<数値>)
DaysAgoInt現在の日付 - n 日を(整数 yyyymmdd として)返しますDaysAgoInt(<数値>)
DaysDiff2 つの日付の間の日数を返しますDaysDiff(<終了日>, <開始日>)
DaysOld年齢(日数)を返しますDaysOld(<日付>)
GetDateサーバーの現在のシステム日付を返しますGetDate()
Hour日付の時間を返しますHour(<日付>)
HoursDiff2 つの日付の間の時間数を返しますHoursDiff(<終了日>, <開始日>)
LocalToUTC現地の日時を UTC に変換しますLocalToUTC(<日付>, <タイムゾーン>)
Minute日付の分を返しますMinute(<日付>)
MinutesDiff2 つの日付の間の分数を返しますMinutesDiff(<終了日>, <開始日>)
Month日付の月を表す数を返しますMonth(<日付>)
MonthsAgo現在の日付 - n ヶ月に対応する日付を返しますMonthsAgo(<数値>)
MonthsDiff2 つの日付の間の月数を返しますMonthsDiff(<終了日>, <開始日>)
MonthsOld年齢(月数)を返しますMonthsOld(<日付>)
Second日付の秒を返しますSecond(<日付>)
Oldest最も古い日付を返しますOldest(<日付>, <日付>)
SecondsDiff2 つの日付の間の秒数を返しますSecondsDiff(<終了日>, <開始日>)
SubDays日付から日数を引きますSubDays(<日付>, <数値>)
SubHours日付から時間数を引きますSubHours(<日付>, <数値>)
SubMinutes日付から分数を引きますSubMinutes(<日付>, <数値>)
SubMonths日付から月数を引きますSubMonths(<日付>, <数値>)
SubSeconds日付から秒数を引きますSubSeconds(<日付>, <数値>)
SubYears日付から年数を引きますSubYears(<日付>, <数値>)
ToDate日付 + 時間を日付に変換しますToDate(<日付 + 時刻>)
ToDateTime文字列を日付 + 時刻に変換しますToDateTime(<文字列>)
ToDateTimeWithTimezone文字列を日付 + タイムゾーンに変換します
: ToDateTimeWithTimezone ("2019-02-19 08:09:00", "Asia/Tehlan")
ToDateTimeWithTimezone(<文字列>)
TruncDate日付 + 時刻を最も近い秒に丸めますTruncDate(@lastModified, <秒数>)
TruncDateTZ日付と時刻を指定された精度(秒)に丸めますTruncDateTZ(<日付>, <秒数>, <タイムゾーン>)
TruncQuarter日付を四半期に丸めますTruncQuarter(<日付>)
TruncTime時刻部分を最も近い秒に丸めますTruncTime(<日付>, <秒数>)
TruncWeek日付を週に丸めますTruncWeek(<日付>)
TruncYear日付 + 時刻をその年の 1 月 1 日に丸めますTruncYear(<日付>)
WeekDay日付の週の日を表す数を返しますWeekDay(<日付>)
Year日付の年を表す数を返しますYear(<日付>)
YearAnd Month日付の年と月を表す数を返しますYearAndMonth(<日付>)
YearsDiff2 つの日付の間の年数を返しますYearsDiff(<終了日>, <開始日>)
YearsOld満年齢を返しますYearsOld(<日付>)

ジオマーケティング

ジオマーケティング関数は、地理に関する値を操作する場合に使用します。

名前説明構文
Distance経度と緯度(度単位)で定義された2 点間の距離をキロメートル単位の値で返しますDistance(<経度 A>, <緯度 A>, <経度 B>, <緯度 B>)

数値

数値関数は、テキストを数値に変換する場合に使用します。

名前
説明
構文
Abs
数値の絶対値を返します
Abs(<数値>)
Ceil
ある特定の数値以上の最小の整数を返します
Ceil(<数値>)
Floor
指定された数値以下の最大の整数を返します
Floor(<数値>)
Greatest
2 つの数のうち大きい方を返します
Greatest(<数値 1>, <数値 2>)
Least
2 つの数のうち小さい方を返します
Least(<数値 1>, <数値 2>)
Mod
整数の割り算 n1 ÷ n2 の余りを返します
Mod(<数値 1>, <数値 2>)
Percent
割合で表される 2 つの数の比率を返します
Percent(<数値 1>, <数値 2>)
Random
ランダムな値を返します
Random()
Round
数値を n 桁に丸めます
Round(<数値>, <小数点以下の桁数>)
Sign
数値の符号を返します
Sign(<数値>)
ToDouble
整数を浮動小数に変換します
ToDouble(<数値>)
ToInt64
浮動小数を 64 ビットの整数に変換します
ToInt64(<数値>)
ToInteger
浮動小数を整数に変換します
ToInteger(<数値>)
Trunc
n1 を n2 の桁数に切り捨てます
Trunc(<n1>, <n2>)

その他

以下の表には、上記以外の使用可能な関数が記載されています。

名前
説明
構文
Case
条件が成り立つ場合は、値 1 を返します。それ以外の場合は、値 2 を返します。
Case(When(<条件>, <値 1>), Else(<値 2>))
ClearBit
値のフラグを削除します
ClearBit(<識別子>, <フラグ>)
Coalesce
値 1 がゼロまたは null の場合は値 2 を返し、それ以外の場合は値 1 を返します
Coalesce(<値 1>, <値 2>)
Decode
値 1 = 値 2 であれば 3 を返し、それ以外の場合は 4 を返します
Decode(<値 1>, <値 2>, <値 3>, <値 4>)
Else
値 1 を返します(case 関数のパラメーターとしてのみ使用できます)
Else(<値 1>)
GetEmailDomain
メールアドレスからドメインを抽出します
GetEmailDomain(<値>)
GetMirrorURL
ミラーページサーバーの URL を取得します
GetMirrorURL(<値>)
Iif
式が true の場合は値 1 を返し、それ以外の場合は値 2 を返します
Iif(<条件>, <値 1>, <値 2>)
IsBitSet
値にフラグが含まれているかどうかを示します
IsBitSet(<識別子>, <フラグ>)
IsEmptyString
文字列が空の場合は値 2 を返し、それ以外の場合は値 3 を返します
IsEmptyString(<文字列>, <値 2>, <値 3>)
NoNull
引数が NULL の場合は、空の文字列を返します
NoNull(<値>)
RowId
ライン番号を返します
RowId
SetBit
値に強制的にフラグを指定します
SetBit(<識別子>, <フラグ>)
ToBoolean
数値をブール値に変換します
ToBoolean(<数値>)
When
式が成り立つ場合は、値 1 を返します。それ以外の場合は、値 2 を返します(ケース関数のパラメーターとしてのみ使用できます)
When(<条件>, <値 1>)
newUUID
新しい UUID を返します
newUUID

文字列

文字列関数は、一連の文字列を操作する場合に使用します。

名前
説明
構文
AllNonNull2
すべてのパラメーターが null でなく空でもないかどうかを示します
AllNonNull2 (<string>, <string>)
AllNonNull3
すべてのパラメーターが null でなく空でもないかどうかを示します
AllNonNull3 (<string>, <string>, <string>)
ASCII
文字列の最初の文字の ASCII 値を返します
Ascii(<文字列>)
Char
ASCII コード「n」に対応する文字を返します
Char (< 数値 >)
Charindex
文字列 1 における文字列 2 の位置を返します
Charindex(<文字列>, <文字列>)
DataLength
文字列に含まれる文字数を返します
DataLength(<文字列>)
GetLine
文字列の n 番目(1 から n)のラインを返します
GetLine (<string>)
IfEquals
最初の 2 つのパラメーターが等しい場合は第 3 パラメーターを返し、それ以外の場合は最後のパラメーターを返します
IfEquals(<文字列>, <文字列>, <文字列>, <文字列>)
IsMemoNull
パラメーターとして渡されたメモが null かどうかを示します
IsMemoNull(<メモ>)
JuxtWords
パラメーターとして渡された 2 つの文字列を連結します。 戻り値に含まれる各文字列の間にスペースが追加されます
JuxtWords(<文字列>, <文字列>)
JuxtWords3
パラメーターとして渡された 3 つの文字列を連結します。 戻り値に含まれる各文字列の間にスペースが追加されます
JuxtWords3(<文字列>, <文字列>, <文字列>)
LPad
左側の完成した文字列を返します
LPad(<文字列>, <数値>, <文字>)
Left
文字列の最初の n 文字を返します
Left (<string>, <number>)
Length
文字列の長さを返します
Length(<文字列>)
Lower
文字列を小文字で返します
Lower (<string>)
Ltrim
文字列の左側の空白を削除します
Ltrim (<string>)
Md5Digest
文字列の MD5 キーの 16 進数表現を返します
Md5Digest (<string>)
MemoContains
パラメーターとして渡す文字列をメモに含めるかどうかを指定します
MemoContains (<memo>, <string>)
RPad
右側の完成した文字列を返します
RPad (<string>, <number>, <character>)
置換
ある文字列(第 1 パラメーター)について、指定された文字列値(第 2 パラメーター)が出現する箇所をすべて別の文字列値(第 3 パラメーター)に置き換えます。
Replace(<文字列>, <文字列>, <文字列>)
Right
文字列の最後の n 文字を返します
Right(<文字列>)
Rtrim
文字列の右側の空白を削除します
Rtrim(<文字列>)
Sha256Digest
指定された UTF8 文字列の標準の SHA256 ハッシュを計算します
Sha256Digest(<String>)
Sha384Digest
指定された UTF8 文字列の標準の SHA384 ハッシュを計算します
Sha384Digest(<文字列>)
Sha512Digest
指定された UTF8 文字列の標準の SHA512 ハッシュを計算します
Sha512Digest(<文字列>)
Smart
各単語の最初の文字を大文字にして文字列を返します
Smart(<文字列>)
Substring
文字列の n1 文字目から始まる長さ n2 文字の部分文字列を抽出します
Substring(<文字列>, <オフセット>, <長さ>)
ToIntlString
数値を文字列に変換します
ToIntlString(<数値>)
ToString
数値を文字列に変換します
ToString(<数値>)
Upper
文字列を大文字で返します
Upper(<文字列>)
VirtualLink
他の 2 つのパラメーターが等しい場合に、パラメーターとして渡されたリンクの外部キーを返します
VirtualLink(<数値>, <数値>, <数値>)
VirtualLinkStr
他の 2 つのパラメーターが等しい場合に、パラメーターとして渡されたリンクの外部(テキスト)キーを返します
VirtualLinkStr(<文字列>, <数値>, <数値>)
encryption_aescbcDecrypt
暗号化された値を 16 進数形式で復号化します。その際に、プレフィックスとして「x」(第 1 パラメーター)を付け、16 進数形式のキー(第 2 パラメーター)と 16 進数形式の初期化ベクター(第 3 パラメーター)を使用します
encryption_aescbcDecrypt(<文字列>, <文字列>, <文字列>)
encryption_aescbcEncrypt
AES アルゴリズム(CBC ブロックモード)に基づき、キー(第 2 パラメーター)と初期化ベクター(第 3 パラメーター)を使用して、文字列(第 1 パラメーター)を暗号化します。キーと初期化ベクターは、16 進数表現(\x で始まる形式)で指定する必要があります。結果は、\x を除いた 16 進数で表されます。
キーのサイズには、128 ビット、192 ビット、256 ビット(16 進数文字で順に 16、24、32)のいずれかを指定できますが、256 ビット、およびキーと同じ長さのランダム化初期化ベクターを使用することをお勧めします
encryption_aescbcEncrypt (<String>, <String>, <String>)
例:encryption_aescbcEncrypt (johndoe@example.com, "\\x0123456789ABCDEF0123456789ABCDEF", "\\x0123456789ABCDEFFEDCBA9876543210")

集計

集計関数は、ワークフローの「Query」アクティビティからさらにデータを追加する場合にのみ使用できます。

集計関数は、一連の値に対して計算を実行する場合に使用します。

名前
説明
構文
平均 、平均
数値列の平均値を返します
Avg(<値>)
Count
列内の null 以外の値をカウントします
Count(<値>)
CountAll
すべての値(null 値および重複値も含め)をカウントします
CountAll()
Countdistinct、Distinct count
列内の null 以外のユニーク値をカウントします
Countdistinct(<値>)
Max
数値、文字列、日付のいずれかの列における最大値を返します
Max(<値>)
Min
数値、文字列、日付のいずれかの列における最小値を返します
Min(<値>)
StringAgg、String aggregate
文字列型の列の値を、2 番目の引数の文字で区切って連結したものを返します(デフォルトの区切り文字はコンマです)。
StringAgg (<string values>,<separator>)
Sum
数値列の値の合計を返します
Sum(<値>)

表示域

表現関数は、値を並べ替える場合に使用します。

名前
説明
構文
Desc
降順ソートを適用します
Desc(<値 1>)
OrderBy
パーティション内の結果を並べ替えます
OrderBy(<値 1>)
PartitionBy
テーブルのクエリの結果を区分します
PartitionBy(<値 1>)
RowNum
テーブルのパーティションと並べ替えシーケンスに基づいて行番号を生成します。この関数は MySQL ではサポートされていません
RowNum(PartitionBy(<値 1>), OrderBy(<値 1>))
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff