文件 Journey Optimizer Journey Optimizer 指南

開始使用協助程式函式 functions

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
個人化

建立對象：

經驗豐富
開發人員

協助程式函式可讓您轉換和操控個人化內容中的資料。使用它們來執行計算、格式化資料、套用條件並執行各種作業，為您的客戶建立動態的量身打造體驗。

這些函式利用Journey Optimizer範本化語言。在此頁面中瞭解個人化語法准則。

➡️ 在此影片中瞭解如何使用協助程式函式

存取輔助函式

協助程式功能可從個人化編輯器的功能表取得：

函式分為三個類別，方便瀏覽：

函式 — 資料操控和轉換作業
協助程式 — 條件式邏輯和公用程式函式
運運算元 — 比較和邏輯運運算元

使用協助程式函式：

選取類別以檢視其子類別和可用函式
按一下>圖示以展開子類別
按一下函式旁的+圖示，將其新增至您的個人化程式碼
按一下...圖示以檢視函式說明，或將其新增至您的最愛。了解更多

NOTE

個人化編輯器中可用的功能和功能，與歷程進階運算式編輯器中可用的功能和功能不同。例如，now()函式僅可用於歷程運算式。了解更多

函式 functions-helper

彙總與陣列函式

此函式傳回陣列中所有選取值的算術平均值

此函式傳回給定陣列中的元素數

此函式計算清單中null值的數量。

此函式計算清單的所有元素，包括null值

此函式從已移除重複值的陣列或清單中取得值

此函式計算不同值的數量，包括空值

此函式傳回陣列或清單中的第一個專案

當根據給定的數值運算式依遞增順序排序時，此函式傳回陣列中的前「N」個專案

在

此函式用於決定專案是陣列或清單的成員

包含

此函式決定陣列或清單是否包含給定專案

相交

此函式決定兩個陣列或清單是否至少有一個通用成員

陣列中的最後n個

當根據給定的數值運算式依遞增順序排序時，此函式傳回陣列中的最後「N」個專案

此函式傳回陣列中所有選取值的最大值

此函式傳回陣列中所有選取值的最小值

此函式決定專案是否不是陣列或清單的成員

此函式決定特定陣列（陣列A）是否是另一個陣列（陣列B）的子集，亦即，如果陣列A中的所有元素都是陣列B的元素

Sum

此函式傳回陣列中所有選定值的總和

超集

此函式決定特定陣列（陣列A）是否是另一個陣列（陣列B）的超集，亦即，該陣列A是否包含陣列B中的所有元素

日期時間函式 date-functions

新增天數

此函式會依指定的天數調整指定日期，使用正值增加值，使用負值減少值。

新增小時

此函式依指定的小時數調整指定日期，使用正值增加值，使用負值減少值。

新增分鐘

此函式以指定的分鐘數調整指定日期，使用正值增加值，使用負值減少值。

新增月份

此函式會依指定的月份數調整指定日期，使用正值增加值，使用負值減少值。

新增秒數

此函式以指定的秒數調整指定日期，使用正值增加值，使用負值減少值。

新增年份

此函式依指定的年數調整指定日期，使用正值增加值，使用負值減少值。

年齡

此函式從指定日期擷取年齡。

年齡（天）

此函式計算指定日期的年齡（以天為單位），即指定日期與目前日期之間經過的天數、未來日期的負數與過去日期的正數。

年齡（月數）

此函式計算指定日期的年齡（月數），即指定日期和目前日期之間經過的月數；若為未來日期的負數，則為過去日期的正數。

比較日期

此函式比較第一個輸入日期與另一個輸入日期。如果date1等於date2，則傳回0；如果date1在date2之前，則傳回–1；如果date1在date2之後，則傳回1。

轉換ZonedDateTime

此函式將日期時間轉換為指定時區。

目前時間（以毫秒為單位）

此函式擷取目前時間（以Epoch毫秒為單位）。

此函式擷取兩個日期之間的天數差。

此函式傳回代表該月某日的數字。

此函式擷取星期幾。

此函式擷取一年當中的第幾天。

此函式傳回兩個日期之間的秒數差。

此函式從指定的時間戳記中擷取小時元件。

此函式從指定的時間戳記中擷取分鐘元件。

此函式從指定的時間戳記中擷取month元件。

擷取秒數

此函式從指定的時間戳記中擷取第二個元件。

格式化日期

此函式格式化日期時間值。

支援地區設定的日期格式

此函式將日期時間值格式化為其對應的語言敏感表示法，亦即所需的地區設定。

取得CurrentZonedDateTime

此函式傳回目前日期和時間，並附上時區資訊。

此函式以時數傳回兩個日期之間的差值。

此函式傳回兩個日期之間的分鐘數差。

此函式傳回兩個日期之間的月差。

此函式為給定的日期時間設定月份日期。

此函式設定日期時間的小時。

此函式將字串轉換為日期。針對無效輸入會傳回epoch日期作為輸出。

到UTC

此函式將日期時間轉換為UTC。

截斷至一天開始

此函式將指定日期時間設為00:00，藉此修改日期時間。

truncateToStartOfQuarter

此函式在00:00將日期時間截斷為其季度的第一天（例如1月1日、4月1日、7月1日、10月1日）。

truncateToStartOfWeek

此函式將指定日期時間設定為一週的開始（星期一的00:00），以修改日期時間。

truncateToStartOfYear

此函式在00:00將指定日期時間截斷為一年的第一天（1月1日），以修改日期時間。

一年中的周

此函式傳回年中的周數

年差異

此函式傳回兩個日期之間的年數差異。

對應函式 map-functions

Get

此函式用於擷取給定索引鍵的對應值

索引鍵

此函式用於擷取給定對應的所有索引鍵

值

此函式擷取給定對應的所有值

數學函式 math-functions

絕對

此函式將任何數字格式化為區分語言的表示法。

格式化數字

此函式將任何數字格式化為區分語言的表示法。

此函式傳回0到1之間的隨機值

此函式對數字進行向下四捨五入

此函式對數字進行向上四捨五入

將任何數字轉換為十六進位字串。

將這些型別（數字、雙精度浮點數、整數、長整數、浮點數、短整數、位元組、布林值、字串）轉換成整數。

至百分比

此函式將數字轉換為百分比

至精確度

此函式將數字轉換為所需的精確度

至字串

此函式將任何數字轉換為其字串表示。

物件函式 object-functions

不是Null

此函式用於決定物件參考是否存在

為空

此函式用於決定物件參考是否不存在

字串函式 string-functions

駝峰式大小寫

此函式用於將字串中每個字詞的第一個字母大寫

字元代碼位於

此函式傳回字元的ASCII值，例如JavaScript中的charCodeAt函式

此函式用於將兩個字串合併為一個

此函式用於決定字串是否包含指定的子字串

此函式用於決定字串是否不包含指定的子字串

此函式用於決定字串的結尾是否不是指定的子字串

開頭不是

此函式用於決定字串的開頭是否不是指定的子字串

編碼64

此函式用於編碼字串

結束於

此函式用於決定字串的結尾是否為指定的子字串

等於

此函式用於決定字串的開頭是否不是指定的子字串，須區分大小寫

等於（忽略大小寫）

此函式用於決定字串是否不以指定的子字串開頭，不區分大小寫

擷取電子郵件網域

此函式用於擷取電子郵件地址的網域

格式化貨幣

此函式根據在第二個引數中作為字串傳遞的區域設定，將任何數字轉換為其對應的語言敏感型貨幣表示

此函式用於取得url主機。

此函式用於取得url路徑

此函式用於取得url通訊協定

此函式傳回第二個引數在第一個引數中第一次出現的位置。如果沒有相符專案，則傳回–1

IsEmpty

此函式用於檢查字串或運算式是否為空。

不是空的

如果引數中的字串不是空的，此函式傳回true。

最後索引：

此函式傳回第二個引數最後一次出現的位置（在第一個引數中）。如果沒有相符專案，則傳回–1。

此函式移除字串開頭的空格

此函式用於取得字串或運算式中的字元數

此函式用於決定字串是否符合指定的模式

此函式將字串轉換為小寫字母

此函式用來以「X」字元取代字串的一部分。

此函式用於決定字串是否符合特定的規則運算式

此函式傳回輸入字串的md5雜湊。

此函式用於決定字串是否不等於指定的字串

此函式比較兩個字串，忽略大小寫。

此函式用於根據提供的規則運算式擷取特定資訊

取代

此函式將字串中的指定子字串替換為另一個子字串

全部取代

此函式以指定的常值「取代」字串取代符合「target」的文字之所有子字串

此函式移除字串結尾的空格

此函式計算並傳回字串的sha256雜湊。

此函式用於依指定字元分割字串

此函式用於決定字串的開頭是否為指定的子字串

字串至日期

此函式將字串值轉換為日期時間值

字串至整數

此函式將字串值轉換為整數值。

字串至數字

此函式用於將字串轉換為數字。對於無效的輸入，它會傳回相同字串作為輸出。

子字串

此函式傳回開始索引和結束索引之間的字串運算式的子字串。

字首大寫

此函式用於將字串中每個字詞的首字母大寫

至Bool

此函式根據其型別將引數值轉換為布林值。

至日期時間

此函式用於將字串轉換為日期。針對無效輸入會傳回epoch日期作為輸出。

僅至日期時間

此函式將引數值轉換為僅日期時間值。針對無效輸入會傳回epoch日期作為輸出。

此函式移除字串開頭和結尾的空格

此函式將字串轉換為大寫字母

此函式用於解碼url編碼的字串。

此函式用於對字串進行url編碼。

輔助程式 helper-helper

協助程式詳細資料於此頁面。

預設遞補值

此函式用於呈現具有預設值的變數

每個

此函式用於反複處理陣列

執行中繼資料

此協助程式會在訊息呈現期間擷取自訂索引鍵值中繼資料，以便將其儲存在執行階段執行中繼資料物件中

若

此函式用於定義條件區塊 — 如果運算式評估傳回true，則會轉譯區塊

Let

此函式允許將運算式儲存為變數，以便稍後在查詢中使用

Unless

此函式用於定義條件區塊 — 如果運算式評估傳回false，則會轉譯區塊

替換為

此函式用於變更範本部分的評估權杖

操作者 operators-helper

算術函式 arithmetic-helper

算術函式用於對值執行基本計算。

此運運算元用於尋找兩個引數運算式的總和

此運運算元用於尋找兩個引數運算式的商

此運運算元用於尋找兩個引數運算式的乘積

此運運算元用來找出兩個引數運算式相除後的餘數

減法

此運運算元求兩個運算式之間的差異

布林函式 boolean-functions

布林值函式用於對不同元素執行布林值邏輯。

與

此運運算元建立邏輯結合

或

此運運算元建立邏輯分離

比較函式 comparison-functions

比較函式是用來比較不同運算式和值之間的差異，並據此傳回true或false。

等於

此操作會檢查值是否相等

大於

此運運算元檢查第一個值是否大於第二個值

大於或等於

此運運算元檢查第一個值是否大於或等於第二個值

小於或等於

此運運算元檢查第一個值是否小於或等於第二個值

不等於

此運運算元檢查給定的運算式是否不等於給定值

作法影片 video

瞭解如何使用個人化協助程式函式來轉換個人化值，並瞭解協助程式函式的不同使用案例。

https://video.tv.adobe.com/v/334244?quality=12

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76