ヘルパー関数の基本を学ぶ

最終更新日： 2025年5月5日

作成対象：

  • 経験者
  • 開発者

Journey Optimizer テンプレート言語を使用して、計算、データの書式設定や変換、条件、パーソナライゼーションのコンテキストでの操作など、データの操作を実行します。パーソナライゼーション構文のガイドラインについて詳しくは、このページを参照してください。

➡️ ヘルパー関数の使用方法については、このビデオをご覧ください

テンプレート言語は、次に示すように、パーソナライゼーションエディターのパーソナライゼーションドロップダウンリストで選択できるヘルパー関数で利用されます。

メモ
パーソナライゼーションエディターで使用できる関数や機能は、ジャーニーの高度な式エディターで使用できる関数や機能とは異なります。

Journey Optimizer パーソナライゼーションエディターでは、ヘルパー関数は関数、ヘルパーおよび演算子の 3 つのカテゴリにグループ化されます。

サブカテゴリと関数にアクセスするには、カテゴリを選択します。

サブカテゴリにアクセスするには、「>」アイコンをクリックします。+ アイコンをクリックして関数を選択すると、その関数がパーソナライゼーション画面に自動的に追加されます。

「...」アイコンをクリックして関数の説明を表示し、お気に入りに追加します。詳細情報

関数

集計関数と配列関数

平均配列内の選択された値すべての算術平均を返します。
カウント指定された配列内の要素数を返します。
Null のみをカウントこの関数はリスト内の null 値の数をカウントします。
null でカウントこの関数は null 値を含むリストのすべての要素をカウントします。
個別重複する値が削除された配列またはリストから値を取得します。
null で個別カウントこの関数は null 値を含む、異なる値の数をカウントします。
最初の項目配列またはリスト内の最初の項目を返します。
配列の最初の n指定した数値式に基づいて昇順で並べ替えられた場合、配列の最初の「N」項目を返します。
次に含まれる項目が配列またはリストのメンバーであるかどうかを判断するために使用します。
次を含む配列またはリストに指定した項目が含まれているかどうかを判定します。
交わり2 つの配列またはリストに、共通メンバーが 1 つ以上あるかどうかを判断します。
配列の最後の n指定した数値式に基づいて昇順で並べ替えられた場合、配列の最後の「N」項目を返します。
最大配列内の選択された値すべての最大値を返します。
最小配列内の選択された値すべての最小値を返します。
次に含まれない項目が配列またはリストのメンバーではないかどうかを判定します。
サブセット特定の配列（配列 A）が別の配列（配列 B）のサブセットであるか、つまり、配列 A のすべての要素が配列 B の要素であるかを判定します。
合計配列内の選択された値すべての合計を返します。
スーパーセットこの関数は、特定の配列（配列 A）が別の配列（配列 B）のスーパーセットであるかどうか、つまり配列 A に配列 B のすべての要素が含まれているかどうかを判定します

日時関数

日数を追加この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された日数で調整します。
時間数を追加この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された時間数で調整します。
分数を追加この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された分数で調整します。
月数を追加この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された月数で調整します。
秒数を追加この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された秒数で調整します。
年数を追加この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された年数で調整します。
経過時間この関数は、指定された日付からの経過時間を取得します。
日数この関数は、指定された日付を日数で、つまり指定された日付と現在の日付の間の経過日数を計算します。将来の日付の場合は負の数、過去の日付の場合は正の数になります。
月数この関数は、指定された日付を月数で、つまり指定された日付と現在の日付の間の経過月数を計算します。将来の日付の場合は負の数、過去の日付の場合は正の数になります。
日付を比較この関数は、最初の入力日付を他の入力日付と比較します。date1 が date2 と等しい場合は 0 を返し、date1 が date2 より前の場合は -1 を返し、date1 が date2 より後の場合は 1 を返します。
ZonedDateTime を変換この関数は、日時を指定されたタイムゾーンに変換します。
現在の時刻（ミリ秒）この関数は、現在の時刻をエポックミリ秒で取得します。
日数の差異この関数は、日数で 2 つの日付間の差異を取得します。
ある月の日付この関数は、その月の日付を表す数値を返します。
曜日この関数は、曜日を取得します。
年間通算日この関数は、年間通算日を取得します。
秒数の差異この関数は、秒数単位で 2 つの日付間の差異を返します。
時間数を抽出この関数は、指定されたタイムスタンプから時間コンポーネントを抽出します。
分数を抽出この関数は、指定されたタイムスタンプから分コンポーネントを抽出します。
月数を抽出この関数は、指定されたタイムスタンプから月コンポーネントを抽出します。
秒数を抽出この関数は、指定されたタイムスタンプから秒コンポーネントを抽出します。
日付を書式設定この関数は、日時値を書式設定します。
日付をロケールサポートの形式にするこの関数は、日付と時刻の値を、目的のロケールなどの対応する言語に依存する表現にフォーマットします。
CurrentZonedDateTime を取得この関数は、タイムゾーン情報を含む現在の日時を返します。
時間数の差異この関数は、時間数単位で 2 つの日付間の差異を返します。
分数の差異この関数は、分数単位で 2 つの日付間の差異を返します。
月数の差異この関数は、月数単位で 2 つの日付間の差異を返します。
日数を設定この関数は、指定された日時の日付を設定します。
時間を設定この関数は、日時の時間を設定します。
日時にこの関数は、文字列を日付に変換します。無効な入力に対する出力として、エポック日付を返します。
UTC にこの関数は、日時を UTC に変換します。
開始日に切り捨てこの関数は、指定された日時を、その日の始まり（00:00）に設定して変更します。
truncateToStartOfQuarterこの関数は、日時を四半期の最初の日（例：1月1日、4月1日、7月1日、10月1日）の 00:00 に切り捨てます。
truncateToStartOfWeekこの関数は、指定された日時を、週の始まり（月曜日の 00:00）に設定して変更します。
truncateToStartOfYearこの関数は、指定された日時を、年の最初の日（1月1日）の 00:00 に切り捨てて変更します。
年間通算週この関数は、年の週番号（何週目か）を返します。
年数の差異この関数は、年数単位で 2 つの日付間の差異を返します。