跳到內容
請注意：：這篇文章的翻譯只是為了方便而提供。譯文透過翻譯軟體自動建立，可能沒有經過校對。因此，這篇文章的英文版本應該是包含最新資訊的管理版本。你可以在這裡存取這些內容。

在工作流程中格式化資料時使用自訂公式函數

上次更新時間： 2026年4月13日

可搭配下列任何訂閱使用，除非另有註明：

如果您正在工作流程中使用自訂公式來格式化資料，您可以運用已加入記錄的屬性值或先前動作的輸出結果來建立複雜公式。 

這些函數不適用於計算屬性。若要檢視計算屬性的運算子、函數等相關資訊，請改為瞭解如何建立自訂方程式計算屬性。 

請參閱以下各種函數，以決定應使用哪一種： 

函數 說明 範例
abs 取得數值的絕對值。您可以使用此函數來確認數值是否為正數。
  • 範例公式： abs([數字或數字屬性])
    • 範例：abs(-10) 
    • 範例輸出：10
add 將一個數值加到另一個數值上。此函數與 + 運算子功能相同。請配合以下內容使用： 
  • number：運算的初始數值。
  • 待加數：將加至初始數值的數值。 
  • 範例公式：add(數字, 待加的數字)
    • 範例：add(5, 10)
    • 範例輸出：15

此外，您也可以使用：

  • 範例公式：數字 + 待加數字
    • 範例：5+10
    • 範例輸出：15
concat 合併多個字串值。此函數僅在「自訂模式」下使用「格式化資料」動作時可用。 
  • 範例公式：concat([字串 1], " ", [字串 2]) 
    • 範例： concat([公司名稱], " ", [月份年份])
    • 範例輸出：HubSpot 2006年6月
首字母大寫 將字串值的首字母大寫。首個字元將轉為大寫，其餘所有字母則轉為小寫。輸入內容中的其他單字首字母不會被大寫
  • 範例公式：capitalize([字串])
    • 範例：capitalize([firstname])
    • 範例輸出：Henry
cut 刪除一個或多個字元以從值中移除字串。此功能可用於匹配並刪除字串的特定部分。參數指定應移除的字串部分。請配合以下功能使用： 
  • source：要從中移除字元的來源字串。 
  • characters_to_cut：要移除的特定字元。此格式區分大小寫。 
  • 公式： cut(來源, 要刪除的字元)
    • 範例： cut([phone], "-")
    • 範例輸出：80081234567 
日期時間格式

請注意：此公式已遭廢棄，並由下方的format_datetime函式取代。使用此函式的操作仍可正常運作，但今後應改用新函式。

  
format_datetime 將時間戳轉換為易於閱讀的格式。請將時間戳或屬性與以下參數一併提供，以設定其格式：
  • format：要使用的格式。可選值包括：'short'、'medium'、'long'、'full'。您也可以使用Unicode LDML 模式指定自訂格式。
  • timeZone：輸出資料的時區，格式為IANA TZDB。預設返回 UTC 時間。
  • locale：用於支援地區設定的格式之地區設定。
  • 公式： format_datetime(date, format, timeZone, locale)
    • 範例： format_datetime([closedate], 'medium', 'America/New_York', 'de-DE')
    • 範例輸出： 2024年2月8日, 17:09:49
divide 對數值進行除法運算。此函式可作為 / 運算子的替代方案。請配合以下內容使用： 
  • number：待除數。 
  • 除數：用於除法的被除數。 
  • 公式：divide(數值, 除數)
    • 範例： divide (8, 4)
    • 範例輸出：2

此外，您也可以使用： 

  • 公式：數字/除數
    • 範例： 8/4
    • 範例輸出：2
可除性 測試一個數是否能被整除。當無餘數時，此函數的結果為 true；當有餘數時，此函數的結果為 false。請配合以下內容使用： 
  • number：待除數。 
  • 除數：用於除法的數。 
  • 公式：divisible(數值, 除數)
    • 範例： 可被 (5,2) 整除
    • 範例輸出：false
join 將兩個或多個字串組合成一個結果字串，並在每個值之間使用分隔符。此功能僅在「自訂模式」下使用「格式化資料」動作時可用。 

適用於以下情況： 
  • 分隔符：插入於各項目之間的分隔字串。
  • 項目：要合併的任意數量字串。 
  • 公式：join(分隔符, 項目)
    • 範例： join("-", "A", "B", "C")
    • 範例輸出：A-B-C
left 從字串值的起始位置開始，擷取該字串值的子字串。此函式僅在「自訂模式」下使用「格式化資料」動作時可用。
  • 公式：left(字串, 長度)
    • 範例： left("Maria", "1")
    • 範例輸出：M
length 返回字串中的字元數。
  • 公式：length(字串)
    • 範例： left("Hello World!")
    • 範例輸出：12
lower 將字串中的所有字元轉換為小寫字母。
  • 公式：lower([字串])
    • 範例： lower(["HELLO WORLD"])
    • 範例輸出：hello world
mid 從字串值中擷取指定範圍的字元子字串。此函式僅在「自訂模式」下使用「格式化資料」動作時可用。
  • 公式：mid(字串, 起始索引, 長度)
    • 範例： join("abc123", 2, 2)
    • 範例輸出：c1
minus_time 從日期/時間物件中減去一段時間。請與以下項目搭配使用： 
  • datetime：要從中減去時間的日期/時間物件。
  • diff：要減去的時間長度。 
  • timeunit：要減去的時間單位。可使用以下選項： 
    • 秒
    • 分鐘
    • 小時
    • 半天
    • 天
    • 週
    • 月
    • 年
  • 公式：minus_time(日期時間, 差值, 時間單位)
    • 範例： minus_time([closedate], 2, "days")
    • 範例輸出：2020/04/11
乘數 將一個值乘以一個數字。此函式可作為 * 運算子的替代方案。請與以下內容搭配使用： 
  • number：待乘的數值。
  • 乘數： 用以進行乘法的數值 。 
  • 公式：multipler(數值, 倍數)
    • 範例：multiplier(5, 3) 
    • 範例輸出：15

此外，您也可以使用：

  • 公式：數字*倍數
    • 範例： 5*3 
    • 範例輸出：15
number 將字串轉換為數字。
  • 公式：number(字串, 預設值?)
    • 範例： left("36")
    • 範例輸出：36
plus_time 將一段時間加到日期/時間物件上。請與以下內容搭配使用： 
  • datetime：要添加時間的日期/時間物件。
  • diff：要增加的時間長度。 
  • timeunit：要追加的時間單位。 
  • 公式：plus_time(日期時間, 時間差, 時間單位)
    • 範例： plus_time([closedate], 2, "days")
    • 範例輸出：2020年6月11日
randomNumber 在指定範圍內產生一個隨機數。

使用此函數生成的數字完全隨機，且可能會重複。例如，若您使用 1 到 3 的範圍並登錄了 3 個聯絡人，您可能無法獲得 3 個唯一的數字。 

範圍內包含最小數和最大數。設定範圍時，您也可以使用 0 和負數。 
  • 公式：randomNumber(minimum, maximum)
    • 範例： randomNumber(1, 3)
    • 範例輸出：1 或 2
replace 將所有子字串的出現位置替換為另一個字串。請配合以下內容使用： 
  • 字串：要搜尋並替換的字串。 
  • old：應被替換的子字串。 
  • new：要替換的字串。 
  • count：要替換的子字串出現次數。若未提供，則會替換所有子字串
  • 公式：replace(字串, 舊值, 新值, 次數)
    • 範例： replace( "Hello world!", "Hello", "Hi", 1)
    • 範例輸出：Hi world!
right 從字串值的末端擷取一段字元子字串。此函式僅在「自訂模式」下使用「格式化資料」動作時可用。
  • 公式：right(字串, 長度)
    • 範例： right("abc123", 3)
    • 範例輸出：123
regex_replace 搜尋正規表達式模式並將其替換為提供的字串。請搭配以下參數使用：
  • original_string：要進行搜尋的原始字串。
  • pattern：要進行比對的正規表達式模式。有關 RE2 語法的資訊可在此處查閱。
  • replacement_string：用以替換模式所匹配字元的字串。
  • 公式： regex_replace(original_string, pattern, replacement_string)
    • 範例： regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • 範例輸出：contactus
root 計算數值的平方根。可選地，指定要計算的第 N 次方根。使用方式如下：
  • number：要計算根號的數。計算數值的平方根。可選地，指定要計算的第 N 次根 
  • nthRoot： 要計算的第 n次 方根。若未指定，則預設計算平方根。 
  • 公式：root(數值, 第 n 次根)
    • 範例： root(625, 4)
    • 範例輸出：5
round 將數值四捨五入至指定的小數位。請配合以下功能使用：
  • precision：要四捨五入的小數位數。 
  • 取圓整方式：向上或向下取圓整至最接近的整數。可使用以下取圓整方式： 
    • common
    • ceil
    • floor
  • 公式：round(數值, 精確度, 取整方式)
    • 範例： round(52.5, 0, 'floor')
    • 範例輸出：52
striptags 移除 SGML/XML 標籤，並將相鄰的空白字元替換為一個空格。此濾鏡可用於從變數中移除任何 HTML 標籤。
  • 公式：striptags([字串])
    • 範例： striptags(<div><p>Potato</p></div>)
    • 範例輸出：Potato
title 將文字轉換為標題格式。結果字串中的每個單字首字母將大寫，其餘字元則為小寫。
  • 公式：title([字串])
    • 範例： title("切達起司")
    • 範例輸出：切達起司
trim 從字串中移除開頭與結尾的空白字元。
  • 公式：trim([字串])
    • 範例： trim(" 蜜桃 ")
    • 範例輸出：peach
Unix 時間戳 將日期/時間物件轉換為 Unix 時間戳記。
  • 公式：unixtimestamp([日期時間])
    • 範例： unixtimestamp([closedate])
    • 範例輸出：1652863824
大寫 將所有字元轉為大寫。
  • 公式：upper([字串])
    • 範例： upper("teatime")
    • 範例輸出：TEATIME
urlencode 使用 UTF-8 格式對字串進行轉義與 URL 編碼。
  • 公式：urlencode([字串])
    • 範例： urlencode("hi there")
    • 範例輸出：hi%20there
這篇文章有幫助嗎？
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。
目錄

相關內容

New call-to-action