建立計算和滾動屬性
上次更新時間: 2025年11月12日
可搭配下列任何訂閱使用,除非另有註明:
-
行銷 Hub Professional, Enterprise
-
銷售 Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional
-
Content Hub Professional, Enterprise
-
智慧 CRM Professional, Enterprise
-
Commerce Hub Professional, Enterprise
您可以建立基於其他屬性計算結果填充數據的屬性。透過彙總屬性,可自動計算關聯記錄中屬性的最小值、最大值、計數、總和或平均值。使用計算屬性時,可根據屬性值間的時間間隔、截止時間或起始時間設定公式,亦可基於物件屬性建立自訂公式。
請注意:您的帳戶可能為每個物件使用自訂名稱(例如使用 account 取代 company)。本文檔均以 HubSpot 預設名稱指稱物件。
例如,您可建立:
- 基於自訂公式計算獲取新客戶成本的公司屬性。
- 聯絡人屬性,用於計算聯絡人相關交易的平均金額。
- 一項交易屬性,用於計算自交易開啟以來的時間長度。
- 發票、訂閱或付款屬性,用於計算扣除所有折扣後的利潤金額。
根據您的 HubSpot 訂閱方案,可建立的計算屬性數量設有上限。
基於關聯記錄屬性建立彙總屬性
您可為物件建立屬性,使其根據該物件關聯記錄的特定屬性值進行計算。計算範圍可涵蓋該物件所有關聯記錄,或僅針對特定關聯標籤(包含同物件關聯)。
例如:可建立一筆交易屬性,統計該交易中標記為「決策者」標籤 之相關聯絡人記錄的銷售活動總數。
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導航至「屬性」。
-
點擊「 選擇物件」下拉式選單 ,選擇[物件] 屬性以建立 該物件的屬性。
- 輸入屬性的基本資訊,然後點擊「欄位類型」標籤頁。
- 點擊「欄位類型」下拉選單並選擇「彙總」。
- 點擊「彙總類型」下拉式選單,然後選擇以下其中一種類型:
- 最小值:顯示所選物件關聯記錄中,所選數值屬性的最小值。
- 最大值:顯示所選物件所有關聯記錄中,所選數值屬性的最大值。
- 計數:統計所選物件中,所有具備所選數值屬性值之關聯記錄的總數。
- 總和:計算所選物件所有關聯記錄中,所選數值屬性的值之總和。
- 平均值:計算所選物件所有關聯記錄中,所選數值屬性的平均值。
- 若要選擇屬性數值的格式,請點擊「數字格式」下拉式選單,從下列格式中選擇:格式化 數字、未格式化數字、貨幣、百分比或 時間長度。
- 若為交易物件選用「貨幣」格式,該物件將預設採用您帳戶的「公司貨幣 」。若需使用各交易記錄的獨立貨幣,請勾選 「使用記錄貨幣而非公司貨幣」核取方塊。採用記錄貨幣僅影響數值顯示方式,不會自動套用匯率。
- 選擇關聯物件與關聯記錄屬性,作為計算該屬性的依據。
- 若需僅依據特定標籤的記錄進行計算,請點擊「選擇關聯標籤」,然後勾選欲包含的標籤。
- 欲新增條件,請點擊「新增條件」。設定附加條件後,該屬性須同時滿足所有條件方能計算(例如:當「近期交易金額>1000且交易成功率 >=80」時計算屬性)。每個彙總屬性最多可設定50項條件。
- 在第一個下拉式選單中選擇屬性。
- 在第二個下拉式選單中,選擇運算子以比較首個屬性值與數字或另一屬性值。
- 在第三個下拉式選單中,選擇屬性或輸入數值,該數值 將與第一個屬性進行比較。
- 點擊儲存。
- 點擊建立。建立後,該屬性顯示的欄位類型將為「彙總」。
請注意:原始持續時間值以毫秒為單位儲存。若在其他 HubSpot 工具(例如篩選器、計算屬性公式)中使用持續時間計算屬性,可能需要採用毫秒值。
建立時間間隔、時間經過或時間剩餘的計算屬性
您可建立屬性以計算兩日期間的時間間隔,或追蹤自某日期起或至某日期止的時間長度,其值取決於日期或日期時間選擇器屬性的設定。時間間隔屬性僅支援相同物件的屬性。
例如:
- 建立「時間間隔」屬性,用於計算工單指派給負責人至關閉期間的時間長度。
- 建立「開啟時間」屬性以追蹤交易案開啟的持續時間。
- 建立「距關閉時間」屬性,追蹤客戶設定的交易關閉日期與今日的間隔。
若需建立以今日日期為基準顯示相對時間(而非屬性值)的屬性,請參閱如何建立相對時間日期/日期時間選擇器屬性。您亦可透過自訂公式建立固定時間屬性。
建立「時間間隔」、「自某時起」或「至某時止」計算屬性的步驟:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導覽至「屬性」。
-
點擊「 選擇物件」下拉式 選單,然後選取[物件] 屬性以 建立該物件的屬性。
- 輸入屬性的基本資訊,然後點擊「 欄位類型」標籤頁 。
- 點擊「欄位類型」下拉選單並選擇「計算」。
- 點擊「計算屬性類型」下拉選單,選擇類型並設定計算公式:
- 時間間隔:選擇起始日期與結束日期屬性 。
- 自某時間起計:選擇日期/日期與時間選擇器 屬性作為起始日期。結束日期將自動設定為今日日期。
- 剩餘時間:選擇日期/日期時間選擇器 屬性作為結束日期。起始日期將自動設定為今日日期。
- 僅限「時間間隔」屬性:欲新增附加條件,請點擊「新增條件」。設定附加條件後,該屬性須同時滿足所有條件方能計算(例如:當「近期交易金額>1000且交易成功率>=80」時計算此屬性)。
- 於第一個下拉式選單中選擇屬性。
- 在第二個下拉式選單中,選擇運算子以比較首個屬性值與數字或另一屬性值。
- 在第三個下拉式選單中,選擇屬性或輸入數值,該數值 將與第一個屬性進行比較。
- 點擊儲存。
- 點擊建立。建立後,該屬性顯示的欄位類型將為「計算」。後續 無法編輯「時間間隔」、 「時間經過」或 「剩餘時間」的類型,但可選擇不同的起始或結束日期屬性。
顯示持續時間值時預期行為如下:
- 對於未含時間戳記的日期屬性,計算時將預設採用選取當日之協調世界時凌晨 12:00。
- 顯示值將依據特定閾值轉換為秒、分鐘、小時、天、月或年。單位閾值如下:
- 2.5 年或更長將以年為單位顯示。
- 3 個月或更長將以月顯示。
- 1天或更長將以天顯示。
- 2.5小時或更長將以小時顯示。
- 2.5分鐘或更長將以分鐘顯示。
- 低於2.5分鐘將以秒為單位顯示。

請注意:在 HubSpot 系統中,「時間間隔」與 「平均值」屬性類型的原始值以毫秒為單位儲存。若使用這些值的公式計算結果高於預期,請使用毫秒轉換器將其轉換為所需的時間單位。
建立自訂公式計算屬性
您亦可建立依據自訂條件計算數值的屬性。自訂公式僅能設定於與新建屬性相同物件內的數值型屬性。例如:可建立公式計算企業最近一筆交易金額(最近交易金額)與貴公司聯繫該企業次數(聯繫次數)的比值。
您可運用算術運算子、比較運算子、邏輯運算子、條件陳述式及其他函數建構自訂公式。這些公式可返回數字、布林值、字串、日期或日期時間值。深入瞭解可用運算子、函數及 公式格式設定方式, 亦可參考常用公式範例。
建立自訂方程式計算屬性步驟:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導覽至「屬性」。
-
點擊「 選擇物件」下拉式 選單,然後選取[物件] 屬性以 建立該物件的屬性。
- 輸入房產的基本資訊,然後點擊「欄位類型」標籤頁。
- 點擊「欄位類型」下拉選單並選擇「計算」。
- 點擊「計算屬性類型」下拉選單,選擇「自訂公式」。
- 點擊「輸出類型」下拉選單,選擇運算結果的輸出格式。可選項目包含:數字、布林值、字串、日期或 日期時間。
請注意:所選輸出類型必須與編輯器右上角顯示的輸出類型相符,否則無法建立屬性。針對返回日期的屬性,可選擇數字或日期輸出類型以決定數值顯示方式(例如:數字類型顯示毫秒級日期,日期類型顯示格式化日期)。
- 若選擇數字輸出類型:
- 點擊「數字格式」下拉選單,選擇屬性數值的格式化方式。可選項目:格式化數字、未格式化數字、貨幣、百分比或 持續時間。
- 若為交易屬性選擇「貨幣」數值格式,該屬性將預設採用您帳戶的「公司貨幣」 。若需使用各筆交易記錄的獨立貨幣,請勾選「 使用記錄貨幣而非公司貨幣」核取方塊。
- 在編輯器中,可插入、輸入或貼上函數與屬性以建立自訂運算式。瞭解更多自訂計算運算式語法。 插入公式元素的方法 :
- 點擊「插入」下拉式選單。
- 若要在公式中插入函數,請選擇「函數」,然後選取函數。
- 若要將屬性插入方程式,請選擇「屬性」,然後選取特定屬性。您僅能使用與當前建立屬性對象相同的屬性來創建自訂方程式。
- 若方程式出現錯誤,請點擊編輯器上方的[x]問題圖示檢視錯誤原因。當方程式存在未解決錯誤時,將無法建立屬性。瞭解如何格式化方程式。
- 預覽公式輸出結果請點擊「測試公式」。
- 點擊「建立」。建立後,該屬性的顯示欄位類型將為「計算」。

請注意:計算公式中最多可嵌套 70 個左括號(例如:(((1+2)+3)+4) 將產生 4 層嵌套)。
運用 AI 建立自訂計算屬性
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導覽至「屬性」。
-
點擊「 選擇物件」下拉式 選單,然後選擇[物件] 屬性以 建立該物件的屬性。
- 輸入屬性的基本資訊,然後點擊「欄位類型」標籤頁。
- 點擊「欄位類型」下拉選單並選擇「計算」。
- 在公式文字欄位下方,點擊「產生公式」。
- 在彈出視窗中:
- 將游標懸停於「範例」連結上,即可查看推薦提示語。
- 在「您希望此屬性為您計算什麼?」文字欄位中輸入提示語。
- 點擊「產生」。
- 檢視生成的公式並視需要進行修改。
- 點擊「輸出類型」下拉式選單,選擇與公式文字欄位顯示值相符的類型(例如:字串)。
- 欲預覽公式輸出結果,請點擊測試公式。
- 點擊建立。

自訂方程式語法
- 文字語法:透過文字資料,您可在方程式中添加文字串、數字及真/假值。文字、數字、布林值與日期常數可依下列方式格式化:
-
字串文字:以引號包圍的文字。可使用單引號(
'constant')或雙引號("constant")表示。 -
數字文字:無引號的數字。常數數字可為任意實數,並可包含小數點表示法。例如
1005與1.5589皆為有效常數。 -
布林常數:可為
true或false。 - 日期文字量值:以毫秒為單位表示的日期。例如:
1698508800000。
-
- 屬性語法:您可在自訂方程式中包含同一物件的其他屬性。
- 若將屬性插入 編輯器,系統會自動將其格式化並驗證為方程式的一部分。
- 若選擇手動輸入或貼上屬性至編輯器,應採用
[properties.{propertyInternalName}]格式。例如要新增 內部值 為 Test_score 的 Test score 屬性,應在編輯器輸入[properties.Test_score]。 - 當方程式中 使用枚舉屬性 (例如下拉式選單、單選按鈕)時,其值將視為字串,必須以雙引號包裹(例如:
"subscriber"),同時需使用屬性選項的內部名稱(例如:"appointmentscheduled")。 - 在方程式中使用日期屬性時,值將以 UTC 午夜為基準,以毫秒為單位儲存。
- 當方程式使用日期時間屬性時,值將儲存為 UTC 紀元時間(以毫秒為單位)。此值會根據使用者所在時區顯示,意味著不同時區的使用者將看到不同數值。
運算符
您可在方程式中使用運算子來更新、評估或比較常數與屬性值。使用多個運算子時,將遵循 PEMDAS 運算優先順序。根據所用資料類型,您可在自訂方程式中包含以下運算子。
| 運算子 | 描述 |
+ |
加法運算數值或字串。返回數值。 |
- |
減去數字。返回一個數字。 |
* |
乘數值。返回數值。 |
/ |
進行數字除法運算。返回一個數字。 |
< |
檢查一個值是否小於另一個值。適用於數字屬性或常數。返回布林值。 |
> |
檢查一個值是否大於另一個值。適用於數字屬性或常數。返回布林值。 |
<= |
檢查值是否小於或等於另一個值。適用於數值屬性或常數。返回布林值。 |
>= |
檢查值是否大於或等於另一個值。適用於數值屬性或常數。返回布林值。 |
! |
檢查所有值是否皆為假。返回布林值。 |
= 或== |
檢查值是否等於另一個值。適用於數字與字串。返回布林值。 |
!= |
檢查值是否不等於另一個值。適用於數字與字串。返回布林值。 |
or 或|| |
檢查兩個值是否至少有一個為真。返回布林值。 |
and 或&& |
檢查兩個值是否皆為真。返回布林值。 |
函數
您可在自訂公式中運用函數計算數值並執行資料操作。根據所用資料類型,自訂方程式可包含下列函數:
| 函數 | 參數 | 範例 |
|
取得數值的絕對值。返回一個數值。 |
number:欲取得絕對值的數值。 |
|
|
|
|
|
|
將最多 100 條字串合併為單一值。返回字串。 |
參數1:將附加參數2的字串。 arg2:要附加至 arg1 的字串。 |
|
|
判斷字串是否包含另一字串(區分大小寫)。返回布林值。 |
text:需檢查子字串的字串或 text 屬性。 子字串:文本應包含的字串。 |
contains("HubSpot", "Spot") |
|
取得貨幣的十進位小數位數。返回一個數字。 |
貨幣:欲計算小數位數的貨幣字串。 |
|
|
取得指定時間的匯率值。返回一個數字。 |
貨幣:欲計算特定日期匯率的貨幣字串(例如: 日期:欲計算匯率的日期時間屬性。 |
|
|
取得最新匯率。返回一個數字。 |
貨幣:欲計算匯率之貨幣字串。 |
|
|
|
|
|
|
建立條件式表達式。 |
條件:決定計算結果的布林陳述式。 參數2:布林值、數字或字串,若條件成立則為計算結果。 參數3(可選):條件未滿足時的計算值。若包含此參數,其類型必須與 |
|
|
判斷代幣是否存在已知值。返回布林值。 |
property:欲檢查值的屬性。 |
|
|
取得代幣上次更新的日期。返回以毫秒為單位的時間戳記字串。 |
property:欲查詢最新更新日期的屬性名稱。 |
|
|
將所有字元轉換為小寫。返回字串。 |
文字:欲轉換為小寫的字串或文字屬性值。 |
|
|
取得兩個數值中的最大值。返回一個數值。 |
參數1:第一個數字或數字屬性。 arg2:第二個數字或數字屬性。 |
|
|
取得兩個數值中的最小值。返回一個數值。 |
參數1:第一個數字或數字屬性。 參數2:第二個數字或數字屬性。 |
|
|
取得指定日期的數值月份。返回一個數字。 |
date:欲計算月份的日期時間屬性。 |
|
|
將數字轉換為字串。返回字串。 |
number_to_convert:欲轉換為字串的數字或數字屬性。 |
|
|
取得管道階段的成功機率。返回數值。 |
pipeline:欲計算機率之管道名稱。 |
|
|
將一個數值提升至另一個數值的冪次。返回數值。 |
base:底數。 指數:要將底數提升至該值的指數。 |
|
|
將數值向下取整至指定精度。返回一個數值。 |
number_to_round:欲向下取整的數值或數值屬性。 precision:向下取整後的十進位小數位數。 |
|
|
將數值四捨五入至指定精度。返回一個數值。 |
number_to_round:欲進行四捨五入的數值或數值屬性。 precision:要四捨五入的十進位小數位數。 |
|
|
將數值向上取整至指定精度。返回一個數值。 |
number_to_round:欲向上取整的數值或數值屬性。 precision:四捨五入後的十進位小數位數。 |
|
|
計算數值的平方根。返回一個數值。 |
number:欲求平方根的數值。 |
|
|
判斷字串是否以另一字串開頭(區分大小寫)。返回布林值。 |
text:欲檢查子字串的字串或文字屬性。 substring:文字應以該字串開頭的字串。 |
|
|
|
|
|
|
將字串轉換為數字。返回一個數字。 |
string_to_convert:欲轉換為數值的字串或文字屬性。 |
|
|
|
|
subtract_time(1699320015000, 1, "second") = 1699320014000 |
|
取得兩個日期之間的時間差。返回一個數字。 |
date1:起始日期時間屬性。 date2:結束日期時間屬性。 |
|
|
將所有字元轉換為大寫。返回字串。 |
text:欲轉換為大寫的字串或文字屬性。 |
|
|
取得指定日期的數值年份。返回一個數字。 |
date:欲計算年份的日期時間屬性。 |
|
檢視自訂公式範例
以下為常見使用情境的公式範例。
使用 if else 判斷式
您可建立 if else 語句,包括含多重條件的語句及函數內的語句。
例如,可建立標記有效交易的計算式。以下公式僅在交易狀態為有效且金額大於零時返回True:
if([properties.amount] < 0 && [properties.dealstage] == "qualifiedtobuy", "True", "False")
執行空值計算
在自訂公式中使用數值屬性時,可透過if 與is_known 函數,將屬性值設為0。如此即使屬性含空值,計算仍可正常執行。範例如下:
if(is_known([properties.number]), [properties.number], 0).
在貨幣計算中附加匯率
在公式中使用記錄貨幣時,若需添加匯率,可於運算式中加入exchange_rate 或dated_exchange_rate 函數。例如:
[properties.amount] * exchange_rate('CAD').
建立固定時間計算式
可設定計算式以取得兩日期間的固定時間。預設會以毫秒為單位返回原始值。您可使用除法運算及round_nearest 函數將結果格式化為小時、天數等單位,並消除最終值的小數部分。例如以下公式將返回固定天數值:
round_nearest((((((([properties.closedate]-[properties.createdate]) / 1000) / 60) ) /60) /24), 0).
請注意:建議在輸入屬性名稱與描述時明確標示,讓使用者清楚知曉計算單位(例如小時或天數)。

以百分比計算交易折扣
在交易中使用明細項目時,可透過彙總屬性與計算屬性追蹤總折扣百分比。彙總屬性會計算 所有關聯明細項目的 「計算總折扣」屬性 值之和;計算屬性則將彙總屬性值除以其自身加上預設交易金額 屬性值。
建立彙總屬性步驟:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導覽至「屬性」。
- 點擊「 選擇物件」下拉選單 ,並選取「交易屬性」。
-
點擊「建立屬性」 ,並選擇「 手動建立」。
- 在「物業標籤」文字欄位中輸入「計算折扣金額」。
- 輸入該物件的其他基本資訊。
- 點擊「欄位類型」標籤頁。
- 點擊「欄位類型」下拉式選單並選擇「彙總」。
- 點擊「彙總類型」下拉式選單並選擇「總和」。
- 點擊「數字格式」下拉式選單 並選擇「貨幣」。
- 點擊「選擇關聯記錄類型」下拉式選單,並選取「明細項目」。
- 點擊「選擇關聯記錄屬性」下拉式選單,並選取「計算總折扣」。
- 在右上角點擊建立。
建立計算屬性步驟:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導覽至「屬性」。
- 點擊「 選擇物件」下拉選單 並選取「交易屬性」。
-
點擊「建立屬性」 ,並選擇「 手動建立」。
- 在「屬性標籤」文字欄位中輸入「計算折扣百分比」。
- 輸入該屬性的其他基本資訊。
- 點擊「欄位類型」標籤頁。
- 點擊「欄位類型」下拉選單並選擇「計算」。
- 點擊「數字格式」下拉選單並選擇「百分比」。
- 在計算公式文字欄位中 輸入:
(Calculated discount amount / (Calculated discount amount + Amount))。您亦可點擊「產生公式」讓 Breeze 自動生成。 - 點擊右上角的「建立」。

