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

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

上次更新時間: 2026年8月3日

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

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

這些函數不適用於計算屬性。若要檢視計算屬性的運算子、函數等相關資訊,請改為參閱「建立自訂方程式計算屬性」的內容。 

 

需要權限 使用工作流程工具需具備「超級管理員」或「工作流程」權限。


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

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

此外,您也可以使用:

  • 範例公式:number + number to add
    • 範例:5+10
    • 範例輸出:15
concat 合併多個字串值。此函式僅在「自訂模式」下使用「格式化資料」動作時才可用。 
  • 公式範例:concat([string 1], " ", [string 2]) 
    • 範例: concat([company name], " ", [MonthYear])
    • 輸出範例:HubSpot 2006年6月
首字母大寫 將字串值的首字母大寫。首個字元將轉為大寫,其餘所有字母則轉為小寫。輸入內容中的其他單字首字母不會被轉為大寫
  • 範例公式:capitalize([string])
    • 範例:capitalize([firstname])
    • 範例輸出:Henry
cut 刪除一個或多個字元,以從值中移除字串。此函式可用於比對並刪除字串中的特定部分。參數用於指定應移除的字串部分。請與以下功能搭配使用: 
  • source:要從中移除字元的來源字串。 
  • characters_to_cut:要移除的特定字元。此格式區分大小寫。 
  • 公式: cut(source, characters to 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')
    • 範例輸出: 08.02.2024, 17:09:49
divide 對數值進行除法運算。此函式可作為 / 運算子的替代方案。請與以下內容搭配使用: 
  • number:待除數。 
  • 除數:用於除法運算的除數。 
  • 公式:divide(number, divisor)
    • 範例: divide (8, 4)
    • 範例輸出:2

此外,您也可以使用: 

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

可與以下項目搭配使用: 
  • 分隔符:插入在每個項目之間的分隔字串。
  • 項目:要合併的任意數量字串。 
  • 公式:join(delimiter, items)
    • 範例: join("-", "A", "B", "C")
    • 範例輸出:A-B-C
left 從字串值的起始位置開始,擷取該字串值中指定長度的子字串。此函式僅在「自訂模式」下使用「格式化資料」動作時才可用。
  • 公式:left(string, length)
    • 範例: left("Maria", "1")
    • 範例輸出:M


length 返回字串中的字元數。
  • 公式:length(string)
    • 範例: left("Hello World!")
    • 範例輸出:12
lower 將字串中的所有字元轉換為全小寫字母。
  • 公式:lower([string])
    • 範例: lower(["HELLO WORLD"])
    • 範例輸出:hello world
mid 從字串值中擷取指定範圍的字元子字串。此函式僅在「自訂模式」下使用「格式化資料」動作時才可用。
  • 公式:mid(string, start-index, length)
    • 範例: join("abc123", 2, 2)
    • 範例輸出:c1
minus_time 從日期/時間物件中減去一段時間。請與以下項目搭配使用: 
  • datetime:要從中減去時間的日期/時間物件。
  • diff:要減去的時間長度。 
  • timeunit:要減去的時間單位。可使用以下選項: 
    • 分鐘
    • 小時
    • 半天
    • 個月
  • 公式:minus_time(datetime, diff, timeunit)
    • 範例: minus_time([closedate], 2, "days")
    • 範例輸出:2020年4月11日
乘數 將一個值乘以一個數。此函式可作為 * 運算子的替代方案。請與以下內容搭配使用: 
  • number:待乘的數值。
  • 乘數: 用來進行乘法的數值 。 
  • 公式:multipler(number, multipler)
    • 範例:multiplier(5, 3) 
    • 範例輸出:15

此外,您也可以使用:

  • 公式:number*multipler
    • 範例: 5*3 
    • 範例輸出:15
number 將字串轉換為數字。
  • 公式:number(string, default?)
    • 範例: left("36")
    • 範例輸出:36
plus_time 將一段時間加到日期/時間物件上。請與以下內容搭配使用: 
  • datetime:要添加時間的日期/時間物件。
  • diff:要增加的時間長度。 
  • timeunit:要追加的時間單位。 
  • 公式:plus_time(datetime, diff, timeunit)
    • 範例: plus_time([closedate], 2, "days")
    • 範例輸出:2020年6月11日


randomNumber 在指定範圍內產生一個隨機數。

使用此函式所產生的數字完全隨機,且可能會重複。例如,若您設定的範圍為 1 到 3,並註冊了 3 位聯絡人,您可能無法獲得 3 個不同的數字。 

範圍內包含最小數值與最大數值。設定範圍時,您也可以使用 0 及負數。 
  • 公式:randomNumber(minimum, maximum)
    • 範例: randomNumber(1, 3)
    • 範例輸出:1 或 2
替換 將所有子字串的出現位置替換為另一個字串。請搭配以下功能使用: 
  • 字串:要搜尋並取代的字串。 
  • old:應被替換的子字串。 
  • new:要替換的字串。 
  • count:要替換的子字串出現次數。若未提供,則會替換所有子字串
  • 公式:replace(string, old, new, count)
    • 範例: replace( "Hello world!", "Hello", "Hi", 1)
    • 範例輸出:Hi world!
right 從字串值的末端擷取一串字元作為子字串並回傳。此函式僅在「自訂模式」下使用「格式化資料」動作時才可用。
  • 公式:right(string, length)
    • 範例: 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(number, nthRoot)
    • 範例: root(625, 4)
    • 範例輸出:5
round 將數值四捨五入至指定的小數位數。請與以下功能搭配使用:
  • precision:要四捨五入的小數位數。 
  • 舍入方式:向上或向下舍入至最接近的整數。可使用以下舍入方式: 
    • common
    • ceil
    • floor
  • 公式:round(number, precision, rounding method)
    • 範例: round(52.5, 0, 'floor')
    • 範例輸出:52
striptags 移除 SGML/XML 標籤,並將相鄰的空白字元替換為一個空格。此濾鏡可用於從變數中移除任何 HTML 標籤。
  • 公式:striptags([string])
    • 範例: striptags(<div><p>Potato</p></div>)
    • 範例輸出:Potato
title 將文字轉換為標題格式。轉換後的字串中,每個單字的首字母將大寫,其餘字元則為小寫。
  • 公式:title([string])
    • 範例: title("cheddar CHEESE")
    • 範例輸出:切達起司
trim 從字串中移除開頭和結尾的空白字元。
  • 公式:trim([string])
    • 範例: trim(" 蜜桃 ")
    • 範例輸出:peach
unixtimestamp 將日期/時間物件轉換為 Unix 時間戳記。
  • 公式:unixtimestamp([dateteime])
    • 範例: unixtimesstamp([closedate])
    • 範例輸出:1652863824
upper 將所有字元轉為大寫。
  • 公式:upper([string])
    • 範例: upper("teatime")
    • 範例輸出:TEATIME
urlencode 使用 UTF-8 格式對字串進行轉義與 URL 編碼。
  • 公式:urlencode([string])
    • 範例: urlencode("hi there")
    • 範例輸出:hi%20there
這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助