建立計算和滾動屬性
上次更新時間: 2026年3月27日
可搭配下列任何訂閱使用,除非另有註明:
-
行銷 Hub Professional, Enterprise
-
銷售 Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional
-
Content Hub Professional, Enterprise
-
智慧 CRM Professional, Enterprise
-
Commerce Hub Professional, Enterprise
您可以建立基於其他屬性計算結果來填入資料的屬性。透過彙總屬性,您可以自動計算相關記錄中屬性的最小值、最大值、計數、總和或平均值。透過計算屬性,您可以根據「之間」、「至」或「自」屬性值設定公式,或根據物件的屬性建立自訂公式。
請注意:您的帳戶可能會為每個物件使用自訂名稱(例如,使用「帳戶」而非「公司」)。本文以 HubSpot 預設名稱來指稱這些物件。
例如,您可以建立:
- 一個根據自訂公式計算新客戶獲取成本的公司屬性。
- 一個聯絡人屬性,用於計算該聯絡人相關交易之平均金額。
- 一個交易屬性,用於計算自交易開啟以來的時間長度。
- 一個能計算適用折扣後利潤金額的發票、訂閱或付款屬性。
根據您的 HubSpot 訂閱方案,可建立的計算屬性數量設有上限。
根據關聯記錄的屬性建立彙總屬性
您可以為某個物件建立屬性,該屬性將根據該物件關聯記錄的特定屬性值進行計算。您可以根據該物件的所有關聯記錄進行計算,或針對特定關聯標籤進行計算,包括同物件關聯。
例如,您可以建立一個交易屬性,用以統計交易中標有「決策者 」標籤的 關聯聯絡人所記錄的銷售活動總數。
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導航至「屬性」。
-
點擊「選取物件」下拉式選單,並選擇[物件] 屬性,以建立該物件的屬性。
- 點擊「建立屬性」。
- 輸入屬性的基本詳細資訊。
- 點擊「欄位類型」下拉式選單,並選擇「匯總」。
- 點擊「匯總類型」下拉式選單,然後選擇以下其中一種類型:
- 最小值:顯示所選物件相關記錄中,所選數字屬性的最小值。
- 最大值:顯示所選物件所有關聯記錄中,所選數字屬性的最大值。
- 計數:統計所選物件中,具有該數值屬性值的關聯記錄總數。
- 總和:計算所選物件所有關聯記錄中,所選數字屬性的數值總和。
- 平均值:計算選取物件所有關聯記錄中,選取數值屬性的平均值。
- 點擊「數字格式」下拉式選單,然後從以下格式中選擇:格式化 數字、未格式化數字、貨幣、百分比或 持續時間。此設定將配置該屬性值的格式。
- 若將「交易」屬性的格式設定為「貨幣」,該屬性預設將使用您帳戶的「公司貨幣」。
- 若要使用各交易記錄的貨幣,請勾選「 使用記錄貨幣而非公司貨幣」核取方塊。使用記錄貨幣僅影響數值的顯示方式,並不會自動套用匯率。
- 選擇關聯物件及關聯記錄屬性,以據此計算該屬性。
- 點擊「選取關聯標籤」,然後選取您要包含的標籤,以便僅根據具有特定標籤的記錄進行計算。
- 按一下「新增條件」以新增記錄必須滿足的可選準則,以便計算該屬性(例如,當「最近交易金額」> 1000 且「交易機率」>=80 時計算該屬性)。每個匯總屬性最多可配置 50 個數字和枚舉欄位類型的條件。
- 在第一個下拉式選單中,選取一個屬性。
- 在第二個下拉式選單中,選取一個運算子,用以將第一個屬性的值與一個數字或另一個屬性的值進行比較。
- 在第三個下拉式選單中,選取一個屬性或輸入一個數值,該數值 將與第一個屬性進行比較。
- 點擊「儲存」。
- 點擊「建立」。建立完成後,該屬性的顯示欄位類型將為「匯總」。
請注意:原始持續時間值以毫秒為單位儲存。如果您在其他 HubSpot 工具(例如篩選器、計算屬性公式)中使用持續時間計算屬性,您可能需要使用毫秒值。
建立「時間間隔」、「自某日時起」或「
至某日時止
」的計算屬性
您可以建立屬性來計算兩個日期之間的時間,或追蹤自某日時起或至某日時止的時間長度,這些時間長度由日期或日期與時間選擇器屬性的值決定。時間間隔屬性僅支援同一物件的屬性。
例如:
- 建立「時間間隔」屬性,以計算工單負責人指派時間與工單關閉時間之間的間隔。
- 建立「開啟後經過時間」屬性,以追蹤交易已開啟多久。
- 建立「距離關閉時間」屬性,以追蹤客戶設定的關閉時間距離今日還有多久。
若要建立其值基於今日日期(而非屬性值)顯示相對時間的屬性,請瞭解如何建立相對時間的日期/日期與時間選擇器屬性。您也可以使用自訂公式建立固定時間屬性。
要建立「時間間隔」、「自開啟以來」或「至關閉為止」的計算屬性:
- 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」。
-
在左側邊欄選單中,導航至「屬性」。
-
點擊「選取物件」下拉式選單,然後選取[物件] 屬性,以建立該物件的屬性。
- 輸入屬性的基本詳細資訊。
- 點擊「欄位類型」下拉式選單,並選擇「計算」。
- 點擊「計算屬性類型」下拉式選單,然後選擇類型並設定計算方式:
- 時間區間:選擇您的「開始日期」和「結束日期」屬性 。
- 「自...起的時間」:選擇其值將作為起始日期的日期/日期與時間選擇器 屬性。結束日期將始終為當日日期。
- 「至時間」:選擇日期/日期與時間選擇器 屬性,其值將作為結束日期。開始日期將始終為當日日期。
- 僅限「時間區間」屬性,請設定其他選項:
- 條件準則:點擊「新增條件」以添加計算時必須滿足的可選準則。
- 僅計算工作日:勾選「排除週末」核取方塊,僅計算起始日期與結束日期之間的平日。週末定義為週六凌晨 12:00 至週日晚上 11:59,時間以您的帳戶時區為準。
- 點擊「建立屬性」。
顯示持續時間值時,預期會出現以下行為:
- 對於沒有時間戳記的日期屬性,計算中使用的預設時間將為所選日期的 UTC 凌晨 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「設定圖示」。
-
在左側邊欄選單中,導航至「屬性」。
-
點擊「選取物件」下拉式選單,然後選取[物件] 屬性,以建立該物件的屬性。
- 點擊「建立屬性」。
- 輸入屬性的基本詳細資訊。
- 點擊「欄位類型」下拉式選單,並選擇「計算」。
- 在公式文字欄下方,點擊「產生公式」。
- 在彈出視窗中:
- 將滑鼠懸停在「範例」連結上,以查看建議的提示文字。
- 在「您希望此屬性為您計算什麼?」文字欄位中,輸入提示文字。
- 點擊「產生」。
- 檢視生成的公式,並視需要進行修改。
- 點擊「輸出類型」下拉式選單,並選擇與公式文字欄位中顯示的值相符的類型(例如:字串)。
- 若要預覽公式的輸出結果,請點擊「測試公式」。
- 點擊「建立屬性」。

自訂方程式語法
- 文字常數語法:使用文字常數,您可以在方程式中加入文字字串、數字以及 true 或 false 值。您可以透過以下方式格式化文字、數字、布林值和日期常數:
-
字串常數:以引號包圍的文字。可使用單引號(
'常數')或雙引號("常數")表示。 -
數字文字常數:不帶引號的數字。常數可以是任何實數,並可包含小數點表示法。例如,
1005和1.5589都是有效的常數。 -
布林常數:布林常數可以是
true或false。 - 日期字面量:以毫秒為單位的日期。例如
1698508800000。
-
- 屬性語法:您可以在自訂方程式中包含同一物件的其他屬性。
- 若將屬性插入 編輯器中,系統會自動將其格式化並作為方程式的一部分進行驗證。
- 若您選擇手動輸入或將屬性貼入編輯器,應格式化為
[properties.{propertyInternalName}]。例如,要新增 內部值 為 Test_score 的 Test score 屬性 ,您應在編輯器中輸入[properties.Test_score]。 - 在方程式中使用枚舉屬性 (例如下拉式選單、單選按鈕)時,其值被視為字串,因此必須以雙引號 ("例如
"subscriber") 包圍,且必須使用屬性選項的內部名稱(例如"appointmentscheduled")。 - 在方程式中使用日期屬性時,值會以 UTC 午夜為基準,以毫秒為單位儲存。
- 在方程式中使用日期時間屬性時,值會以 UTC 紀元(Epoch)為單位,以毫秒形式儲存。此值會根據您的時區進行顯示。這意味著不同時區的用戶將看到不同的數值。
運算子
您可以在方程式中使用運算子來更新、評估或比較常數與屬性值。當使用多個運算子時,它們遵循 PEMDAS 運算順序。根據您使用的資料類型,您可以在自訂方程式中包含以下運算子。
| 運算子 | 說明 |
+ |
對數字或字串進行加法運算。返回一個數字。 |
- |
從數值中減去另一個數值。傳回一個數值。 |
* |
對數字進行乘法運算。傳回一個數字。 |
/ |
將數字相除。返回一個數字。 |
< |
檢查一個值是否小於另一個值。適用於數字屬性或常數。傳回一個布林值。 |
> |
檢查一個值是否大於另一個值。適用於數字屬性或常數。傳回布林值。 |
<= |
檢查一個值是否小於或等於另一個值。支援數值屬性或常數。傳回布林值。 |
>= |
檢查一個值是否大於或等於另一個值。適用於數字屬性或常數。傳回布林值。 |
! |
檢查所有值是否皆非真。傳回布林值。 |
=或== |
檢查一個值是否等於另一個值。適用於數字和字串。傳回布林值。 |
!= |
檢查一個值是否不等於另一個值。適用於數字和字串。傳回布林值。 |
or或|| |
檢查兩個值中是否有任一個為真。傳回布林值。 |
and或&& |
檢查兩個值是否皆為真。傳回布林值。 |
函數
您可以在自訂公式中使用函數來計算數值並對資料執行操作。根據您使用的資料類型,可在自訂公式中包含以下函數。
| 函數 | 參數 | 範例 |
|
取得數值的絕對值。傳回一個數值。 |
number:要取得其絕對值的數。 |
|
|
|
|
|
|
將最多 100 個字串組合成一個值。回傳一個字串。 |
arg1:將接在 arg 2 後面的字串。 arg2:要附加至 arg1 的字串。 |
|
|
判斷一個字串是否包含另一個字串(區分大小寫)。傳回布林值。 |
text:要檢查是否包含該子字串的字串或 text 屬性。 substring:文字應包含的字串。 |
contains("HubSpot", "Spot") |
|
取得貨幣的小數位數。回傳一個數字。 |
currency:要計算小數位數的貨幣字串。 |
|
|
取得指定時間點的匯率值。回傳一個數字。 |
貨幣:您要針對其計算特定日期匯率的貨幣字串(例如 日期:您要計算匯率的日期時間屬性。 |
|
|
取得最新的匯率。傳回一個數值。 |
貨幣:您要計算匯率的貨幣字串。 |
|
|
|
|
|
|
建立一個條件式。 |
條件:決定計算結果的布林陳述式。 arg2:若條件成立時,將作為計算結果的布林值、數字或字串。 arg3(可選):若條件未滿足時的計算結果。若包含此參數,其類型必須與 |
|
|
判斷該標記是否已知其值。傳回布林值。 |
property:要檢查其值的屬性。 |
|
|
取得代幣最後更新的日期。傳回以字串形式表示的毫秒時間戳記。 |
property:您要查詢最近更新日期的屬性。 |
|
|
將所有字元轉為小寫。回傳一個字串。 |
text:您要轉換為小寫的字串或文字屬性。 |
|
|
取得兩個數值中的最大值。回傳一個數值。 |
arg1:第一個數值或數值屬性。 arg2:第二個數值或數值屬性。 |
|
|
取得兩個數值中的最小值。回傳一個數值。 |
arg1:第一個數字或數字屬性。 arg2:第二個數值或數值屬性。 |
|
|
取得指定日期的數值月份。傳回一個數字。 |
date:要計算月份的日期時間屬性。 |
|
|
將數字轉換為字串。回傳字串。 |
number_to_convert:您要轉換為字串的數字或數字屬性。 |
|
|
取得管道階段的機率。回傳一個數值。 |
pipeline:您要計算其機率的管道名稱。 |
|
|
將一個數提升至另一個數的冪。傳回一個數。 |
底數:運算的底數。 冪次:要將底數提升至的冪次。 |
|
|
將數值向下取整至指定精確度。返回一個數值。 |
待四捨五入的數值:您要向下取整的數值或數值屬性。 精確度:向下取整的小數位數。 |
|
|
將數值四捨五入至指定精確度。返回一個數值。 |
待圓整數:您要對其值進行圓整的數值或數值屬性。 精確度:要四捨五入的小數位數。 |
|
|
將數值向上取整至指定精確度。回傳一個數值。 |
待四捨五入的數值:您要向上四捨五入的數值或數值屬性。 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「設定圖示」。
-
在左側邊欄選單中,導航至「屬性」。
- 點擊「選擇物件」下拉選單,並選擇「交易屬性」。
-
點擊「建立屬性」。
- 在「屬性標籤」文字欄位中,輸入「計算折扣百分比」。
- 點擊「欄位類型」下拉式選單,並選擇「計算」。
- 點擊「數字格式」下拉式選單,並選擇「百分比」。
- 在計算公式文字欄位中,輸入
(計算出的折扣金額 / (計算出的折扣金額 + 總金額))。您也可以點擊「產生公式」讓 Breeze 自動生成公式。 - 點擊「建立屬性」。

