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

建立計算和滾動屬性

上次更新時間: 2025年11月12日

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

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

請注意:您的帳戶可能為每個物件使用自訂名稱(例如使用 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. 僅限「時間間隔」屬性:欲新增附加條件,請點擊「新增條件」。設定附加條件後,該屬性須同時滿足所有條件方能計算(例如:當「近期交易金額>1000且交易成功率=80」時計算此屬性)。
    • 於第一個下拉式選單中選擇屬性
    • 在第二個下拉式選單中,選擇運算子以比較首個屬性值與數字或另一屬性值。
    • 在第三個下拉式選單中,選擇屬性或輸入數值,該數值 將與第一個屬性進行比較。
    • 點擊儲存
  8. 點擊建立。建立後,該屬性顯示的欄位類型將為「計算」。後續 無法編輯「時間間隔」、 「時間經過」或 「剩餘時間」的類型,但可選擇不同的起始或結束日期屬性。

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

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

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

A HubSpot property details screen for 'Peter Burke'. The 'Course duration' field is highlighted, showing a value of '3.7 months'.

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

建立自訂公式計算屬性

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

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

建立自訂方程式計算屬性步驟:

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

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

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

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

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

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

A form for creating a HubSpot calculated property. The highlighted custom equation concatenates 'First Name' and 'Last Name', with 'Neal Caffrey' as the output.

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

運用 AI 建立自訂計算屬性

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

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

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

GIF displaying property create screen. User creates a calculation property. They select a 'generate formula' button to build the formula with AI.

自訂方程式語法

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

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

    • 布林常數:可為truefalse

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

運算符

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

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

函數

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

函數 參數 範例

abs

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

abs(number)

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

abs(-100) = 100

add_time

將指定單位的時間值加至基準時間。

add_time(base, timeToAdd, unit)

基准時間:基准時間。

timeToAdd:需添加至基準時間的時長。

unit:表示時間單位的參數,可選值包含:timeToAdd second minute hour day week month year

add_time(1699320015000, 1, “second”) = 1699320016000

concatenate

將最多 100 條字串合併為單一值。返回字串。

concatenate("arg 1", "arg 2")

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

arg2:要附加至 arg1 的字串。

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

contains

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

contains(text, substring)

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

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

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

contains("HubSpot", "Spot")

currency_decimal_places

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

currency_decimal_places(currency)

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

currency_decimal_places("USD")

dated_exchange_rate

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

dated_exchange_rate(currency, date)

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

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

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

exchange_rate

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

exchange_rate(currency)

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

exchange_rate("USD")

euler

返回歐拉常數值。

euler()

euler() = 2.71828

if

建立條件式表達式。

if(condition, arg2)if(condition, arg2, arg3)

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

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

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

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

is_known

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

is_known(property)

property:欲檢查值的屬性。

is_known([properties.name]) = true

last_updated

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

last_updated(property)

property:欲查詢最新更新日期的屬性名稱。

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

lowercase

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

lowercase(text)

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

lowercase("heLLo") = "hello"


lowercase([properties.test])

max

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

max(arg1, arg2)

參數1:第一個數字或數字屬性。

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

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

min

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

min(arg1, arg2)

參數1:第一個數字或數字屬性。

參數2:第二個數字或數字屬性。

min(500, 250) = 250

month

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

month(date)

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:底數。

指數:要將底數提升至該值的指數。

power(5, 2) = 25

round_down

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

round_down(number_to_round, precision)

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

precision:向下取整後的十進位小數位數。

round_down(4.353, 1) = 4.3

round_nearest

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

round_nearest(number_to_round, precision)

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

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

round_nearest(4.32, 1) = 4.3

round_up

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

round_up(number_to_round, precision)

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:欲檢查子字串的字串或文字屬性。

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

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

starts_with("HubSpot", "Hub")

string_length

返回指定字串的長度

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:基準時間。

時間差值:需從基準時間扣除的時間量。

unit:表示時間單位的參數,可選值包含:timeToSubtract second minute hour day week month year

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

time_between

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

time_between(date1, date2)

date1:起始日期時間屬性。

date2:結束日期時間屬性。

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

uppercase

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

uppercase(text)

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

uppercase("hello") = "HELLO"

year

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

year(date)

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).

請注意:建議在輸入屬性名稱與描述時明確標示,讓使用者清楚知曉計算單位(例如小時或天數)。

A HubSpot property details screen for 'Peter Burke'. The value for 'Course duration fixed number of days' is highlighted, showing '113'.

以百分比計算交易折扣

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

建立彙總屬性步驟:

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

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

  5. 在「物業標籤」文字欄位中輸入「計算折扣金額」。
  6. 輸入該物件的其他基本資訊
  7. 點擊「欄位類型」標籤頁。
  8. 點擊「欄位類型」下拉式選單並選擇「彙總」。
  9. 點擊「彙總類型」下拉式選單並選擇「總和」。
  10. 點擊「數字格式」下拉式選單 並選擇「貨幣」。
  11. 點擊「選擇關聯記錄類型」下拉式選單,並選取「明細項目」。
  12. 點擊「選擇關聯記錄屬性」下拉式選單,並選取「計算總折扣」。
  13. 在右上角點擊建立

建立計算屬性步驟:

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

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

  5. 在「屬性標籤」文字欄位中輸入「計算折扣百分比」。
  6. 輸入該屬性的其他基本資訊
  7. 點擊「欄位類型」標籤頁。
  8. 點擊「欄位類型」下拉選單並選擇「計算」。
  9. 點擊「數字格式」下拉選單並選擇「百分比」。
  10. 計算公式文字欄位中 輸入:(Calculated discount amount / (Calculated discount amount + Amount)) 。您亦可點擊「產生公式」讓 Breeze 自動生成。
  11. 點擊右上角的「建立」。

HubSpot calculated property settings showing a custom equation for a percentage discount, with formula and sample output.

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