開始使用協助程式函式

最後更新： 2025年8月26日

建立對象：

  • 經驗豐富
  • 開發人員

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

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

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

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

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

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

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

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

函數

彙總與陣列函式

平均此函式傳回陣列中所有選取值的算術平均值
Count此函式傳回給定陣列中的元素數
只計算 Null此函數計算清單中 null 值的數量。
計算 Null此函式計算清單的所有元素，包括null值
相異此函式從已移除重複值的陣列或清單中取得值
Null 的相異計數此函式計算不同值的數量，包括空值
第一個項目此函式傳回陣列或清單中的第一個專案
陣列中的前 n 個當根據給定的數值運算式依遞增順序排序時，此函式傳回陣列中的前「N」個專案
位於此函式用於決定專案是陣列或清單的成員
包括此函式決定陣列或清單是否包含給定專案
相交此函式決定兩個陣列或清單是否至少有一個通用成員
陣列中的最後 n 個當根據給定的數值運算式依遞增順序排序時，此函式傳回陣列中的最後「N」個專案
最大值此函式傳回陣列中所有選取值的最大值
最小值此函式傳回陣列中所有選取值的最小值
不在此函式決定專案是否不是陣列或清單的成員
子集:此函式決定特定陣列（陣列A）是否是另一個陣列（陣列B）的子集，亦即，如果陣列A中的所有元素都是陣列B的元素
Sum此函式傳回陣列中所有選定值的總和
超集:此函式決定特定陣列（陣列A）是否是另一個陣列（陣列B）的超集，亦即，該陣列A是否包含陣列B中的所有元素

日期時間函式

增加天數此函式會依指定的天數調整指定日期，使用正值增加值，使用負值減少值。
增加小時數此函式依指定的小時數調整指定日期，使用正值增加值，使用負值減少值。
增加分鐘數此函式以指定的分鐘數調整指定日期，使用正值增加值，使用負值減少值。
增加月數此函式會依指定的月份數調整指定日期，使用正值增加值，使用負值減少值。
增加秒數此函式以指定的秒數調整指定日期，使用正值增加值，使用負值減少值。
增加年數此函式依指定的年數調整指定日期，使用正值增加值，使用負值減少值。
年齡此函式從指定日期擷取年齡。
年齡 (以天為單位)此函式計算指定日期的年齡（以天為單位），即指定日期與目前日期之間經過的天數、未來日期的負數與過去日期的正數。
年齡 (以月為單位)此函式計算指定日期的年齡（月數），即指定日期和目前日期之間經過的月數；若為未來日期的負數，則為過去日期的正數。
比較日期此函數會將第一個輸入日期與另一個輸入日期進行比較。如果 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 來修改該日期時間。
年中的週此函式傳回年中的周數
年差此函式傳回兩個日期之間的年數差異。

對應函數

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

數學函數

絕對此函式將任何數字格式化為區分語言的表示法。
格式化數字此函式將任何數字格式化為區分語言的表示法。
隨機此函數傳回 0 到 1 之間的隨機值
向下四捨五入此函數對數字進行向下四捨五入
向上四捨五入此函式對數字進行向上四捨五入
至十六進位字串將任何數字轉換為十六進位字串。
ToInt將這些型別（數字、雙精度浮點數、整數、長整數、浮點數、短整數、位元組、布林值、字串）轉換成整數。
至百分比此函數將數字轉換為百分比
至精確度此函數將數字轉換為所需的精確度
至字串此函式將任何數字轉換為其字串表示。

物件函數

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

字串函數

駝峰式大小寫此函式用於將字串中每個字詞的第一個字母大寫
字元代碼位於此函式傳回字元的ASCII值，例如JavaScript中的charCodeAt函式
Concat此函式用於將兩個字串合併為一個
包含此函式用於決定字串是否包含指定的子字串
不包含此函式用於決定字串是否不包含指定的子字串
結尾不是此函式用於決定字串的結尾是否不是指定的子字串
開頭不是此函式用於決定字串的開頭是否不是指定的子字串
編碼64此函式用於編碼字串
結束於此函式用於決定字串的結尾是否為指定的子字串
等於此函式用於決定字串的開頭是否不是指定的子字串，須區分大小寫
等於忽略大小寫此函式用於決定字串是否不以指定的子字串開頭，不區分大小寫
擷取電子郵件網域此函式用於擷取電子郵件地址的網域
格式化貨幣此函式根據在第二個引數中作為字串傳遞的區域設定，將任何數字轉換為其對應的語言敏感型貨幣表示
取得 url 主機此函數用於取得 URL 主機。
取得 url 路徑此函式用於取得url路徑
取得 url 通訊協定此函式用於取得url通訊協定
索引:此函式傳回第二個引數在第一個引數中第一次出現的位置。如果沒有相符專案，則傳回–1
IsEmpty此函式用於檢查字串或運算式是否為空。
不是空的如果參數中的字串不為空，則此函數傳回 true。
最後索引:此函數傳回第二個引數最後一次出現的位置 (在第一個引數中)。如果沒有相符項目，則傳回 -1。
左側修剪此函式移除字串開頭的空格
長度此函式用於取得字串或運算式中的字元數
類似此函式用於決定字串是否符合指定的模式
小寫此函式將字串轉換為小寫字母
遮罩此函式用來以「X」字元取代字串的一部分。
符合此函數用於決定字串是否符合特定的規則運算式
MD5此函數傳回輸入字串的 md5 雜湊。
不等於此函式用於決定字串是否不等於指定的字串
不等於，忽略大小寫此函數比較兩個字串，忽略大小寫。
規則運算式群組此函式用於根據提供的規則運算式擷取特定資訊
取代此函式將字串中的指定子字串替換為另一個子字串
全部取代此函式以指定的常值「取代」字串取代符合「target」的文字之所有子字串
右側修剪此函式移除字串結尾的空格
SHA256此函式計算並傳回字串的sha256雜湊。
分割此函式用於依指定字元分割字串
開始於此函式用於決定字串的開頭是否為指定的子字串
字串至日期此函式將字串值轉換為日期時間值
字串至整數此函數會將字串值轉換為整數值。
字串至數字此函數用於將字串轉換為數字。針對無效輸入會傳回相同字串作為輸出。
子字串此函數傳回開始索引和結束索引之間的字串運算式的子字串。
字首大寫此函式用於將字串中每個字詞的首字母大寫
至 Bool此函數根據其類型將引數值轉換為布林值。
至日期時間此函數用於將字串轉換為日期。針對無效輸入會傳回 epoch 日期作為輸出。
僅至日期時間此函式將引數值轉換為僅日期時間值。 針對無效輸入會傳回epoch日期作為輸出。
修剪此函式移除字串開頭和結尾的空格
大寫此函式將字串轉換為大寫字母
Url 解碼此函數用於解碼 URL 編碼的字串。
Url 編碼此函數用於對字串進行 URL 編碼。