文件 Journey Optimizer Journey Optimizer 指南

開始使用協助程式函式 functions

Last update: Mon Apr 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：
個人化

建立對象：

經驗豐富
開發人員

使用Journey Optimizer範本化語言對資料執行作業，例如計算、資料格式設定或轉換、條件，並在個人化的內容中加以處理。在此頁面上瞭解個人化語法准則。

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

在個人化編輯器的個人化下拉式清單提供的協助程式功能中，會運用範本語言，如下所示：

NOTE

個人化編輯器中可用的功能和功能，與歷程進階運算式編輯器中可用的功能和功能不同。

在Journey Optimizer個人化編輯器中，協助程式功能分為三個類別：功能、協助程式和運運算元。

選取類別，以存取子類別和函式。

按一下>圖示即可存取子類別。按一下+圖示來選取函式：函式會自動新增至個人化畫面。

按一下...圖示可檢視函式的說明，並將其新增至您的最愛。了解更多

函數 functions-helper

彙總與陣列函式

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

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

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

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

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

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

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

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

位於

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

包括

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

相交

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

陣列中的最後 n 個

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

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

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

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

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

總和

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

超集:

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

日期時間函式 date-functions

增加天數

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

增加小時數

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

增加分鐘數

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

增加月數

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

增加秒數

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

增加年數

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

年齡

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

年齡 (以天為單位)

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

年齡 (以月為單位)

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

比較日期

此函數會將第一個輸入日期與另一個輸入日期進行比較。如果 date1 等於 date2，則傳回 0；如果 date1 在 date2 之前，則傳回 -1；如果 date1 在 date2 之後，則傳回 1。

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

此函式以紀元毫秒為單位擷取目前時間。

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

此函數會傳回表示當月日次的數字。

此函式擷取星期幾。

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

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

此函數會從給定的時間戳記中擷取小時部分。

此函數會從給定的時間戳記中擷取分鐘部分。

此函數會從給定的時間戳記中擷取月份部分。

此函數會從給定的時間戳記中擷取秒數部分。

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

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

此函數會傳回目前日期和時間以及時區資訊。

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

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

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

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

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

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

到 UTC

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

截斷至當天的開始

此函數會透過將給定日期時間設定為當天的開始並將時間設定為 00:00 來修改該日期時間。

截斷至季的開始

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

截斷至週的開始

此函數會透過將給定日期時間設定為當週的開始 (星期一的 00:00) 來修改該日期時間。

截斷至年的開始

此函數會透過將給定日期時間截斷至該年第一天 (1 月 1 日) 的 00:00 來修改該日期時間。

年中的週

此函式傳回年中的周數

年差

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

對應函數 map-functions

取得

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

索引鍵

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

值

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

數學函數 math-functions

絕對

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

格式化數字

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

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

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

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

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

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

至百分比

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

至精確度

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

至字串

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

物件函數 object-functions

不是 Null

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

是 Null

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

字串函數 string-functions

駝峰式大小寫

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

字元代碼位於

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

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

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

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

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

開頭不是

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

編碼64

此函式用於編碼字串

結尾為

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

等於

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

等於忽略大小寫

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

擷取電子郵件網域

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

格式化貨幣

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

此函數用於取得 URL 主機。

此函式用於取得url路徑

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

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

IsEmpty

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

不是空的

如果參數中的字串不為空，則此函數傳回 true。

最後索引:

此函數傳回第二個引數最後一次出現的位置 (在第一個引數中)。如果沒有相符項目，則傳回 -1。

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

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

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

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

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

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

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

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

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

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

取代

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

全部取代

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

右側修剪

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

分割

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

開頭為

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

字串至日期

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

字串至整數

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

字串至數字

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

子字串

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

字首大寫

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

至 Bool

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

至日期時間

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

僅至日期時間

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

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

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

此函數用於解碼 URL 編碼的字串。

此函數用於對字串進行 URL 編碼。

輔助程式 helper-helper

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

預設遞補值

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

Each

此函式用於反複處理陣列

若

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

Let

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

Unless

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

With

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

操作者 operators-helper

算術函式 arithmetic-helper

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

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

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

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

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

減法

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

布林函式 boolean-functions

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

與

此運運算元建立邏輯結合

或

此運運算元建立邏輯分離

比較函式 comparison-functions

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

等於

此操作會檢查值是否相等

大於

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

大於或等於

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

小於或等於

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

不等於

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

作法影片 video

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

video poster

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

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76