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

建立計算和滾動屬性

上次更新時間: 2026年1月30日

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

您可以建立基於其他屬性計算結果填充資料的屬性。透過彙總屬性,可自動計算關聯記錄中屬性的最小值、最大值、計數、總和或平均值。使用計算屬性時,可根據屬性值間的時間間隔、截止時間或起始時間設定公式,亦可基於物件屬性建立自訂公式。 

請注意:您的帳戶可能為每個物件使用自訂名稱(例如使用 account 取代 company)。本文將以 HubSpot 預設名稱指稱物件。

例如,您可以建立:

  • 一個公司屬性,透過自訂公式計算獲取新客戶的成本。
  • 聯絡人屬性:計算聯絡人相關交易的平均金額。 
  • 一項交易屬性,用於計算自交易開啟以來的時間長度。
  • 發票、訂閱或付款屬性,用於計算折扣適用後的實際利潤金額。

根據您的 HubSpot 訂閱方案,可建立的計算屬性數量設有上限

基於關聯記錄屬性建立彙總屬性

您可為物件建立屬性,使其根據該物件關聯記錄的特定屬性值進行計算。計算範圍可涵蓋該物件所有關聯記錄,或僅針對特定關聯標籤(包含同物件關聯)。

例如:建立一筆交易屬性,統計標記為「決策者 標籤的 關聯聯絡人針對該交易所記錄的銷售活動總數。

  1. 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」
  2. 於左側邊欄選單中,導覽至「屬性」。

  3. 點擊「選擇物件下拉式選單,選取[物件] 屬性以建立該物件的屬性。

  4. 點擊建立屬性
  5. 輸入屬性的基本資訊。
  6. 點擊「欄位類型」下拉式選單,選擇「彙總」
  7. 點擊「彙總類型」下拉式選單,選擇下列任一類型:
    • 最小值:顯示所選物件關聯記錄中,所選數值屬性的最小值。
    • 最大值:顯示所選物件所有關聯記錄中,所選數值屬性的最大值。
    • 計數:統計所選物件中所有具備該數值屬性值之關聯記錄總數。
    • 總和:計算所選物件所有關聯記錄中,所選數值屬性的值之總和。
    • 平均值:計算所選物件所有關聯記錄中,所選數值型屬性的平均值。
  8. 點擊「數字格式」下拉式選單,從下列格式中選擇:格式化 數字未格式化數字貨幣百分比或 時間長度。此設定將配置屬性數值的顯示格式。
    • 若為交易屬性選取「貨幣」格式,該屬性將預設採用您帳戶的「公司貨幣」。
    • 若需採用各交易記錄的獨立貨幣,請勾選「 使用記錄貨幣而非公司貨幣」核取方塊。使用記錄貨幣僅影響數值顯示方式,不會自動套用匯率。
  9. 選擇關聯物件關聯記錄屬性,作為計算屬性的依據。 
  10. 點擊「選擇關聯標籤」,選取欲納入計算的標籤,僅針對特定標籤的記錄進行計算。
  11. 點擊「新增條件」可設定記錄須滿足的選用判斷條件(例如:當近期交易金額> 1000 且交易成功率>=80 時計算該屬性)。每個彙總屬性最多可設定 50 項數字與枚舉欄位類型的條件。
    • 在第一個下拉式選單中選擇屬性
    • 在第二個下拉式選單中,選擇運算子以比較首個屬性值與數字或另一屬性值。
    • 在第三個下拉式選單中,選擇一個屬性或輸入一個數字,該數字 將與第一個屬性進行比較。
    • 點擊儲存
  12. 點擊建立。建立後,該屬性顯示的欄位類型將為「彙總」。

請注意:原始持續時間值以毫秒為單位儲存。若您在其他 HubSpot 工具(例如篩選器、計算屬性公式)中使用持續時間計算屬性,可能需要採用毫秒值

建立時間間隔、時間經過或剩餘時間計算屬性

您可以建立屬性來計算兩個日期之間的時間間隔,或追蹤自某日期起經過的時間長度,亦可計算至某日期前的剩餘時間,這些計算皆基於日期或日期時間選擇器屬性的數值。時間間隔屬性僅支援同物件的屬性計算。

例如:

  • 建立「時間間隔」屬性以計算工單指派負責人至關閉工單之間的時間。
  • 建立「開啟後經過時間」屬性以追蹤交易案開啟的持續時間。
  • 建立「距關閉時間」屬性,追蹤客戶設定的關閉日期與今日的距離。

若需建立以今日日期為基準顯示相對時間值(而非屬性值)的屬性,請參閱如何建立相對時間日期/日期時間選擇器屬性。您亦可透過自訂公式建立固定時間屬性

建立「時間間隔」、「開啟後時間」或「關閉前時間」計算屬性的步驟:

  1. 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」
  2. 於左側邊欄選單中,導覽至「屬性」。

  3. 點擊「選擇物件下拉選單,選擇[物件] 屬性以建立該物件的屬性。

  4. 輸入屬性的基本資訊
  5. 點擊「欄位類型」下拉選單並選擇「計算」。
  6. 點擊「計算屬性類型」下拉式選單,選擇類型並設定計算規則:
    • 時間間隔:選擇起始日期結束日期屬性
    • 自起始時間:選擇日期/日期與時間選擇器 屬性作為起始日期。結束日期將自動設定為今日日期。
    • 剩餘時間:選擇日期/日期時間選擇器 屬性作為結束日期。開始日期將自動設定為今日日期。
  7. 僅限「時間間隔」屬性:點擊「新增條件可添加計算時需滿足的選用判斷條件
  8. 點擊建立屬性。 
建立後,屬性顯示的欄位類型將為 計算。後續 無法編輯其類型 (時間區間、 自某時起算 至某時止), 但可選擇不同的起始日或結束日屬性。

請注意: 以下情境不支援「自某時起」「至某時止」屬性:

  • 自訂報表建構器的篩選條件。
  • 計算屬性與彙總屬性的輸入欄位。
  • 自訂資料同步欄位對應設定

顯示持續時間值時預期行為如下:

  • 對於未包含時間戳記的日期屬性,計算時預設採用選取當日之 UTC 凌晨 12:00。
  • 顯示值將依據特定閾值轉換為秒、分鐘、小時、天、月年。單位轉換閾值如下:
    • 2.5 年或更長將以年為單位顯示。
    • 3 個月或更長將以月顯示。
    • 1天或更長將以天數顯示。
    • 2.5小時或更長將以小時顯示。
    • 2.5分鐘或更長將以分鐘顯示。
    • 低於2.5分鐘將以秒為單位顯示。

請注意:在 HubSpot 系統中,「時間間隔」與「平均值屬性類型的原始數值均以毫秒為單位儲存。若使用這些數值的公式運算結果高於預期,請使用毫秒轉換器將其轉換為所需的時間單位。

建立自訂方程式計算屬性

您亦可建立依據自訂條件計算數值的屬性。自訂方程式僅能設定於與新建屬性相同物件內的數值型屬性。例如:可建立方程式計算企業最近一筆交易金額(最近交易金額)與貴公司聯繫該企業次數(聯繫次數)的比值。

您可運用算術運算子、比較運算子、邏輯運算子、條件陳述式及其他函數建構自訂公式。這些公式可返回數字、布林值、字串、日期或日期時間值。深入瞭解可用運算子函數 及公式格式設定方式亦可參考常用公式範例

建立自訂公式計算屬性的步驟:

  1. 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」
  2. 於左側邊欄選單中,導覽至「屬性」。

  3. 點擊「選擇物件下拉式選單,選取[物件] 屬性以建立該物件的屬性。

  4. 輸入屬性的基本資訊
  5. 點擊「欄位類型」下拉選單並選擇「計算」。
  6. 點擊「計算屬性類型」下拉式選單,選擇「自訂公式」。
  7. 點擊「輸出類型」下拉選單,選擇運算結果的輸出格式。可選項目包含:數字布林值字串日期或 日期時間

請注意:所選輸出類型必須與編輯器右上角顯示的輸出類型相符,否則無法建立屬性。針對返回日期的屬性,可選擇數字或日期輸出類型,此設定將決定數值顯示方式(例如:數字類型顯示毫秒級日期,日期類型顯示格式化日期)。

  1. 若選擇數字輸出類型:
    • 點擊「數字格式」下拉選單,選擇屬性值的格式化方式。可選項目包括:格式化數字未格式化數字貨幣百分比 或持續時間
    • 若為交易屬性選擇「貨幣」作為數字格式,該屬性將預設採用您帳戶的「公司貨幣」 。若需使用每筆交易記錄的貨幣,請勾選「 使用記錄貨幣而非公司貨幣」核取方塊。
請注意:使用 數字輸出類型時需遵循以下規則:
  • 採用記錄貨幣僅影響數值顯示方式,不會自動套用匯率。若需添加匯率,請在公式中加入exchange_ratedated_exchange_rate 函數
  • 若自訂公式中的數值屬性存在無效值或空值,計算將中止且計算屬性值將為空。即使公式包含常數,值仍會保持空值。此時可運用ifis_known 函數將值設定為 0。

  1. 在編輯器中,可插入、輸入或貼上函數與屬性來建立自訂公式。深入瞭解自訂計算公式的語法。 插入公式元素的方法
    • 點擊「插入」下拉式選單。
    • 若要在方程式中插入函數,請選擇「函數」,然後選取所需函數
    • 若要將屬性插入方程式,請選擇「屬性」,然後選取所需屬性。請注意:自訂方程式僅能使用與該屬性所屬物件相同的屬性來建立。
  2. 若方程式存在錯誤,請點擊編輯器上方的[x]問題圖示檢視錯誤原因。當方程式存在未解決錯誤時,將無法建立屬性。瞭解如何格式化方程式。
  3. 預覽公式輸出效果,請點擊「測試公式」
  4. 點擊建立屬性
建立後,屬性顯示的欄位類型將為 計算式

請注意:計算公式中最多可嵌套 70 個左括號(例如(((1+2)+3)+4)將產生 4 層嵌套)。

運用 AI 建立自訂計算屬性

  1. 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」
  2. 於左側邊欄選單中,導覽至「屬性」。

  3. 點擊「選擇物件」下拉選單,選取[物件]屬性以建立該物件的屬性。

  4. 點擊建立屬性
  5. 輸入屬性的基本資訊
  6. 點擊「欄位類型」下拉式選單並選擇「計算式」。
  7. 在公式文字欄位下方,點擊「產生公式」。
  8. 在彈出視窗中:
    • 將游標懸停於「範例」連結上,即可查看推薦提示語。
    • 在「您希望此屬性為您計算什麼?」文字欄位中輸入提示語
    • 點擊「產生」。
  9. 檢視生成的公式並視需要進行修改。
  10. 點擊「輸出類型」下拉式選單,選擇與公式文字欄位顯示值相符的類型(例如:字串)。
  11. 欲預覽公式輸出結果,請點擊測試公式
  12. 點擊建立屬性

自訂方程式語法

  • 文字語法:透過文字資料,您可在方程式中加入文字串、數字及真/假值。文字、數字、布林值與日期常數可依下列方式格式化:
    • 字串文字:以引號包圍的文字。可使用單引號('常數')或雙引號("常數")表示。

    • 數字文字:無引號的數字。常數數字可為任意實數,並可包含小數點表示法。例如10051.5589皆為有效常數數字。

    • 布林常數:可取值為truefalse

    • 日期文字:以毫秒為單位表示的日期。例如:1698508800000
  • 屬性語法:您可在自訂方程式中包含同一物件的其他屬性。
    • 若將屬性插入 編輯器,系統會自動格式化並驗證其作為方程式的一部分。
    • 若選擇手動輸入或貼上屬性至編輯器,應採用[properties.{propertyInternalName}]格式。例如要新增 內部值Test_scoreTest score 屬性 ,應輸入 [properties.Test_score]
    • 當方程式中 使用枚舉屬性 (例如下拉式選單、單選按鈕)時,其值將視為字串,必須以雙引號包裹(例如:"訂閱者"),同時需使用屬性選項的內部名稱(例如:"appointmentscheduled")。
    • 在方程式中使用日期屬性時,值將以 UTC 午夜為基準,以毫秒為單位儲存。
    • 當方程式使用日期時間屬性時,值將儲存為 UTC 紀元時間(以毫秒為單位)。此值會根據使用者所在時區顯示,意味著不同時區的使用者將看到不同數值。

運算子

您可在方程式中使用運算子來更新、評估或比較常數與屬性值。使用多個運算子時,將遵循 PEMDAS 運算優先級規則。根據所用資料類型,您可在自訂方程式中包含以下運算子:

運算符 說明
+ 加法運算數值或字串。返回數值。
- 減去數字。返回一個數字。
* 乘以數字。返回一個數字。
/ 除法運算。返回一個數值。
< 檢查一個值是否小於另一個值。適用於數字屬性或常數。返回布林值。
> 檢查值是否大於另一個值。適用於數字屬性或常數。返回布林值。
<= 檢查一個值是否小於或等於另一個值。適用於數值屬性或常數。返回布林值。
>= 檢查值是否大於或等於另一個值。適用於數值屬性或常數。返回布林值。
! 檢查所有值是否皆為假。返回布林值。
=== 檢查值是否等於另一個值。適用於數字與字串。返回布林值。
!= 檢查值是否不等於另一個值。支援數字與字串。返回布林值。
or|| 檢查兩個值中是否至少有一個為真。返回布林值。
and&& 檢查兩個值是否皆為真。返回布林值。

函數

您可在自訂公式中使用函數來計算值並執行資料操作。根據所用資料類型,您可在自訂方程式中包含以下函數:

函數 參數 範例

abs

取得數值的絕對值。返回一個數值。

abs(number)

number:欲取得絕對值的數值。

abs(-100)= 100

add_time

將指定時間以指定單位為基準時間加總。

add_time(base, timeToAdd, unit)

基准時間:基准時間。

時間量:要添加至基准時間的時長。

單位:表示新增時間的單位。選項包含分鐘小時月或

add_time(1699320015000, 1, "second")= 1699320016000

concatenate

將最多 100 個字串組合為單一值。返回字串。

concatenate("參數 1", "參數 2")

參數1:將附加參數2的字串。

參數 2:要附加至參數 1 的字串。

concatenate("範例", " 測試")= "範例 測試"

包含

判斷字串是否包含另一字串(區分大小寫)。返回布林值。 

contains(text, substring)

text:要檢查子字串的字串或文字屬性。

子字串:文本應包含的字串。

contains([properties.name], "Spot")

contains("HubSpot", "Spot")

貨幣小數位數

取得貨幣的十進位小數位數。返回一個數字。

currency_decimal_places(貨幣)

貨幣:欲計算小數位數的貨幣字串。

currency_decimal_places("USD")

匯率日期

取得指定時間點的匯率值。返回一個數字。 

指定日期匯率

貨幣:欲計算特定日期匯率的貨幣字串(例如「USD」)。

日期:欲計算匯率的日期時間屬性。

dated_exchange_rate("USD", [properties.closedate])

exchange_rate

取得最新匯率。返回一個數字。

exchange_rate(貨幣)

貨幣:欲計算匯率的貨幣字串。

匯率("USD")

歐拉常數

返回歐拉常數值。

歐拉常數()

euler()= 2.71828

if

建立條件式表達式。

if(條件, 參數2)if(條件, 參數2, 參數3)

條件:決定計算結果的布林陳述式。

參數2:布林值、數字或字串,若條件成立則為計算結果。 

參數3(可選):條件未滿足時的計算值。若包含此參數,其類型必須與參數2相同。若未使用參數3,則條件未滿足時值為null。 

if([properties.amount] > 1000, "large", "small")

 

is_known

判斷代幣是否已知該值。返回布林值。

is_known(property)

property:欲檢查數值的屬性。

is_known([properties.name])= true

last_updated

取得代幣上次更新的日期。返回以毫秒為單位的時間戳記字串。

last_updated(property)

屬性:欲檢查其最新更新日期的屬性。

last_updated([properties.amount])= "1672531200000"

lowercase

將所有字元轉換為小寫。返回字串。

lowercase(文字)

文字:欲轉換為小寫的字串或文字屬性值。

lowercase("heLLo")= "hello"


lowercase([properties.test])

最大值

取得兩個數值中的最大值。返回一個數值。 

max(arg1, arg2)

arg1:第一個數字或數字屬性。

arg2:第二個數字或數字屬性。

max(500,[properties.amount])= 500,若金額值小於 500。

min

取得兩個數值中的最小值。返回一個數值。

min(arg1, arg2)

arg1:第一個數字或數字屬性。

arg2:第二個數字或數字屬性。

min(500, 250)= 250

month

取得指定日期的數值月份。返回一個數字。

month(date)

日期:欲計算月份的日期時間屬性。

month([properties.closedate])

number_to_string

將數字轉換為字串。返回字串。

number_to_string(number_to_convert)

number_to_convert:欲轉換為字串的數字或數字屬性。

number_to_string(1000)= "1000"

pipeline_probability

取得管道階段的機率。返回一個數字。

pipeline_probability(pipeline)

pipeline:欲計算機率之管道名稱。

pipeline_probability("newdeal")

power

將一個數值提升至另一個數值的冪次。返回一個數值。

power(base, exponent)

base:底數。

exponent:要將基數提升至的指數值。

power(5, 2)= 25

round_down

將數值向下取整至指定精度。返回一個數值。

round_down(待四捨五入數值, 精度)

number_to_round:欲向下取整的數值或數值屬性。

precision:四捨五入後的十進位小數位數。

round_down(4.353, 1)= 4.3

round_nearest

將數值四捨五入至指定精度。返回一個數值。

round_nearest(待四捨五入的數值, 精度)

number_to_round:欲進行四捨五入的數值或數值屬性。

precision:要四捨五入的小數位數。

round_nearest(4.32, 1)= 4.3

round_up

將數值向上取整至指定精度。返回一個數值。

round_up(需四捨五入的數值, 精度)

number_to_round:欲向上取整的數值或數值屬性。

precision:四捨五入後的十進位小數位數。

round_up(4.353, 1)= 4.4

sqrt

取得數值的平方根。返回一個數值。

sqrt(number)

number:欲求平方根的數值。

sqrt(144)= 12

starts_with

判斷字串是否以另一字串開頭(區分大小寫)。返回布林值。

starts_with(text, substring)

text:欲檢查是否包含子字串的字串或 text 屬性。

substring:文字應以該字串開頭的子字串。

starts_with([properties.name], "Hub") 

starts_with("HubSpot", "Hub")

字串長度

返回指定字串的長度

string_length(text)

text:要檢查長度的字串或文字屬性。

string_length("Wow")= 3

string_to_number

將字串轉換為數字。返回一個數字。

string_to_number(string_to_convert)

string_to_convert:欲轉換為數字的字串或文字屬性。

string_to_number("1000")= 1000

subtract_time

從基準時間中減去指定時間,並由指定單位控制。

subtract_time(base, timeToAdd, unit)

base:基準時間。

要扣除的時間:從基準時間扣除的時間量。

單位:表示要扣除時間的單位。選項包括分鐘小時月或

subtract_time(1699320015000, 1, "second") = 1699320014000

時間間隔

取得兩個日期之間的時間差。返回一個數字

時間間隔(日期1, 日期2)

date1:起始日期時間屬性。

date2:結束日期時間屬性。

time_between([properties.createdate],[properties.closedate])

大寫

將所有字元轉換為大寫。返回字串。

uppercase(text)

text:欲轉換為大寫的字串或文字屬性。

uppercase("hello")= "HELLO"

年份

取得指定日期的數值年份。返回一個數字。

year(date)

日期:欲計算年份的日期時間屬性。

year([properties.closedate])

檢視自訂公式範例

以下為常見使用情境的範例公式。

使用 if else 語句

可設定 if else 語句,包含多條件陳述式及函數內嵌語句

。 例如:建立標記有效交易的計算式。以下公式僅在交易狀態為有效且金額大於零時返回True

  • if([properties.amount] < 0 && [properties.dealstage] == "qualifiedtobuy", "True", "False")

執行空值計算

在自訂公式中使用數字屬性時,可透過ifis_known 函數將空值屬性設為 0。如此即使屬性含空值,計算仍可正常執行。例如:

  •  if(is_known([properties.number]), [properties.number], 0).

在貨幣計算中附加匯率

於公式中使用記錄貨幣時,若需添加匯率,可將exchange_ratedated_exchange_rate 函數納入運算式。例如:

  • [properties.amount] * exchange_rate('CAD')

建立固定時間計算式

可設定計算式以取得兩日期間的固定時間間隔。預設會以毫秒為單位返回原始值。您可運用除法運算與round_nearest函數將結果格式化為小時、天數等單位,並消除最終值的小數部分。例如以下公式將返回固定天數值:

  • round_nearest((((((([properties.closedate]-[properties.createdate]) / 1000) / 60) ) /60) /24), 0)

請注意:建議在輸入屬性名稱與描述時明確標示計算單位(例如小時或天數),以便使用者理解計算時間的維度。

以百分比計算交易折扣

在交易中使用明細項目時,可透過彙總屬性與計算屬性追蹤總折扣百分比。彙總屬性會計算 所有關聯明細項目的「計算總折扣」屬性值總和 ;計算屬性則將彙總屬性值除以其自身加上預設交易 金額屬性值。

建立彙總屬性:

  1. 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」
  2. 於左側邊欄選單導覽至「屬性」。

  3. 點擊「選擇物件」下拉選單並選取「交易物件屬性」。
  4. 點擊建立屬性

  5. 在「屬性標籤」文字欄位輸入「計算折扣金額」。
  6. 點擊「欄位類型」下拉式選單並選擇「彙總」
  7. 點擊「彙總類型」下拉式選單並選擇「總和」。
  8. 點擊「數字格式」下拉式選單並選擇「貨幣」。
  9. 點擊「選擇關聯記錄類型」下拉式選單,並選取「明細項目」。
  10. 點擊「選擇關聯記錄屬性」下拉式選單,並選取「計算總折扣」。
  11. 點擊建立屬性

建立計算屬性步驟:

  1. 在你的 HubSpot 帳戶中,點擊頂端導覽列中的settings「設定圖示」
  2. 在左側邊欄選單中,導航至「屬性」。

  3. 點擊「選擇物件」下拉選單並選取「交易屬性」。
  4. 點擊建立屬性

  5. 在「屬性標籤」文字欄位中輸入「計算折扣百分比」。 
  6. 點擊「欄位類型」下拉式選單並選擇「計算」。
  7. 點擊「數字格式」下拉選單並選擇「百分比」。
  8. 在計算公式文字欄位中輸入:(計算折扣金額 / (計算折扣金額 + 金額))。您亦可點擊「產生公式」讓 Breeze 自動生成。
  9. 點擊建立屬性

這篇文章有幫助嗎?
此表單僅供記載意見回饋。了解如何取得 HubSpot 的協助