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

自定義公式函數

上次更新時間： 二月 12, 2024

可与下列任何一种订阅一起使用，除非有说明：

Operations Hub   Professional , Enterprise

如果您使用自訂公式來格式化工作流程中的資料，則可以使用具有已註冊記錄的屬性值的函數或先前操作的輸出來建立複雜的公式。 

查看下面的不同功能，以確定要使用哪種功能： 

功能 描述 示例
abs 檢索數字的絕對值。 您可以使用此功能確保數字為正數。
  • 範例公式： abs ([數字或數字屬性])
    • 例如： abs (-10) 
    • 範例輸出： 10
添加 將數值添加到另一個數值。 此函數與+運算符相同。 與下列項目配合使用： 
  • number ：操作的初始數值。
  • number to add ：要添加到初始數值的數字。 
  • 示例公式： add (number, number to add)
    • 示例： add (5, 10)
    • 範例輸出： 15

或者，您也可以使用：

  • 示例公式： number + number to add
    • 示例： 5 +10
    • 範例輸出： 15
concat 組合多個字串值。 只有在「自訂」模式下使用「格式化資料」動作時，此功能才可用。 
  • 示例公式： CONCAT ([string 1], "", [string 2])
    • 示例： CONCAT ([公司名稱], "", [月份])
    • 範例輸出： HubSpot 2006年6月
capitalize 將字串值的第一個字母大寫。 第一個字元將為大寫，而所有其他字母將為小寫。 輸入中的其他單詞的第一個字母不會大寫
  • 示例公式： capitalize ([string])
    • 示例： CAPITALIZE ([firstname])
    • 範例輸出： Henry
剪切 剪切一個或多個字元以從值中刪除字串。 此函數可用於匹配和剪切字符串的特定部分。 參數指定應移除的字串部分。 與下列項目配合使用： 
  • source ：要從中移除字符的源字符串。 
  • characters_to_cut ：要移除的特定字符。 此格式區分大小寫。 
  • 公式: cut (source, characters to cut)
    • 例如： cut ([phone], "-")
    • 範例輸出： 80081234567 
datetimeformat

請注意：此公式已被棄用，取而代之的是下面的format_datetime函數。 使用此功能的操作將繼續運作，但應繼續使用新功能。

  
format_datetime 將時間戳記轉換為人性化格式。 包含時間戳記或屬性以及下列參數以配置其格式：
  • format ：要使用的格式。 值包括： 'short'、'medium'、'long'、'full'。 您也可以使用Unicode LDML模式指定自定義格式。
  • timeZone ： IANA TZDB格式輸出資料的時區。 預設會傳回UTC時間。
  • locale ：用於語言環境感知格式的語言環境。
  • 公式： FORMAT_DATETIME (日期,格式, timeZone,地區)
    • 示例： FORMAT_DATETIME ([CLOSEDATE], 'MEDIUM', 'AMERICA/NEW_YORK,' DE-DE ')
    • 範例輸出 ： 08.02.2024, 17:09:49
除 除以數字。此函數是/運算符的替代方案。 與下列項目配合使用： 
  • number ：要除以的數字。 
  • divisor ：除法運算要除以的數字。 
  • 公式： divide (number, divisor)
    • 示例： divide (8, 4)
    • 範例輸出： 2

或者，您也可以使用： 

  • formula: number/divisor
    • 示例： 8/4
    • 範例輸出： 2
可分割 測試數字是否均勻可分。 當沒有剩餘時，此函數將評估為true。 當有餘數時，此函數將評估為false。 與下列項目配合使用： 
  • number ：要除以的數字。 
  • divisor ：除法運算要除以的數字。 
  • formula: divisible (數字,除數)
    • 示例： divisible (5,2)
    • 範例輸出： false
加入 使用每個值之間的分隔符，將兩個或多個字串合併成一個結果字串。 只有在「自訂」模式下使用「格式化資料」動作時，此功能才可用。 

與下列項目配合使用： 
  • delimiter ：要在每個項目之間插入的分隔符串。
  • items ：任意數量的字符串。 
  • 公式: JOIN (分隔符號,項目)
    • 示例： join ("-", "A", "B", "C")
    • 範例輸出： A-B-C
左 從字符串值的開頭返回字符串值的字符子字符串。 只有在「自訂」模式下使用「格式化資料」動作時，此功能才可用。
  • formula: left (string, length)
    • 例如： left ("Maria", "1")
    • eXAMPLE OUTPUT: M
length 返回字符串中的字符數。
  • formula: length (string)
    • 例如： left ("Hello World!")
    • 範例輸出： 12
降低 將字串中的所有字元轉換為所有小寫字母。
  • 公式： lower ([string])
    • 例如： lower (["HELLO world"])
    • 示例輸出： hello world
mid 從字符串值返回字符的子字符串。 只有在「自訂」模式下使用「格式化資料」動作時，此功能才可用。
  • formula: mid (string, start-index, length)
    • 示例： join ("abc123", 2, 2)
    • 示例輸出： c1
minus_time 從日期/時間物件中減去時間量。 與下列項目配合使用： 
  • datetime ：要添加時間的日期/時間物件。
  • diff ：要添加的時間量。 
  • timeunit ：要添加的時間單位。 可以使用以下方法：
    • 秒
    • 分
    • 小時
    • half_days
    • 天
    • 周
    • 月
    • 年
  • 公式： minus_time (datetime, diff, timeunit)
    • 示例： minus_time ([closedate], 2, "days")
    • 範例輸出： 04/11/2020
乘數 將數值乘以數字。 此函數是*運算符的替代方案。 與下列項目配合使用： 
  • number ：要乘以的數字。
  • multiplier ：要乘以的數字。 
  • 公式： MULTIPLER (number, multipler)
    • 例如： multiplier (5, 3) 
    • 範例輸出： 15

或者，您也可以使用：

  • formula: number * multipler
    • 示例： 5 * 3 
    • 範例輸出： 15
number 將字串轉換為數字。
  • formula: number (string, default?)
    • 例如： left ("36")
    • 範例輸出： 36
plus_time 向日期/時間物件新增時間量。 與下列項目配合使用： 
  • datetime ：要添加時間的日期/時間物件。
  • diff ：要添加的時間量。 
  • timeunit ：要添加的時間單位。 
  • 公式： plus_time (datetime, diff, timeunit)
    • 示例： plus_time ([closedate], 2, "days")
    • 範例輸出： 06/11/2020
randomNumber 在一定範圍內產生隨機數。

使用此函數，生成的數字是完全隨機的，可能會重複。 例如，如果您使用1至3個範圍，並註冊了三個聯絡人，則可能無法獲得三個唯一的號碼。 

最小和最大數字都包含在範圍內。 設定範圍時，您也可以使用0和負數。 
  • 公式： randomNumber （最小值，最大值）
    • 示例： randomNumber (1, 3)
    • 範例輸出： 1或2
replace 將子字串的所有實例替換為不同的字串。 與下列項目配合使用： 
  • string ：要搜索和替換的字串。 
  • old ：應替換的子字符串。 
  • new ：替換字串。 
  • count ：要替換的子字串實例數。 如果未提供，將更換所有子字串
  • 公式： replace (string, old, new, count)
    • 示例： replace ("Hello world!", "您好", "您好", 1)
    • 示例輸出： Hi world!
右 從字符串值返回字符串值末尾的字符子字符串。 只有在「自訂」模式下使用「格式化資料」動作時，此功能才可用。
  • formula: right (string, length)
    • 例如： right ("abc123", 3)
    • 範例輸出： 123
root 計算數字的平方根。 （可選）指定要計算的第N個根。 與下列項目配合使用：
  • number ：取根的數字。計算數字的平方根。 （可選）指定要計算的第N個根 
  • nthRoot ：要計算的第n個根。 如果未指定，將採用平方根。 
  • formula: root (number, nthRoot)
    • 例如： root (625, 4)
    • 範例輸出： 5
round 將數字四捨五入到指定的小數。 與下列項目配合使用：
  • precision ：要舍入的小數位數。 
  • 舍入方法：向上或向下舍入到最接近的整數。 可以使用以下舍入方法：
    • common
    • 天花板
    • 地板
  • formula: round (number, precision, rounding method)
    • 例如： round (52.5, 0, 'floor')
    • 範例輸出： 52
striptags 剝離SGML/XML標籤，並將相鄰空格替換為一個空格。 此篩選器可用於從變數中刪除任何HTML標籤。
  • formula: striptags ([string])
    • 例如： striptags (< div > < p > Potato

      )
    • 範例輸出： Potato
title 將文字更改為標題大小寫。 生成的字符串中的每個單詞都將以大寫字母開頭，而其餘所有字符均為小寫。
  • 公式： title ([string])
    • 例如： title ("Cheddar CHEESE")
    • 輸出範例：切達乾酪
裁剪 從字串中移除前導和尾隨空格。
  • formula: trim ([string])
    • 例如： trim ("peach")
    • 範例輸出： peach
unixtimestamp 將日期/時間物件轉換為Unix時間戳記。
  • 公式： unixtimestamp ([dateteime])
    • 例如： unixtimesstamp ([closeate])
    • 範例輸出： 1652863824
upper 將所有字元變更為大寫。
  • formula: upper ([string])
    • 例如： upper ("teatime")
    • 範例輸出： TEATIME
urlencode Escape和URL使用UTF-8格式對字串進行編碼。
  • formula: urlencode ([字符串])
    • 例如： urlencode ("hi there")
    • 範例輸出： hi % 20there
這篇文章有幫助嗎？
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助。
目錄 /zh-tw/workflows/custom-formula-functions

相關內容