跳到内容
请注意::本文仅为方便您阅读而提供。本文由翻译软件自动翻译,可能未经校对。本文的英文版应被视为官方版本,您可在此找到最新信息。您可以在此处访问。

创建计算和卷积属性

上次更新时间: 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. 点击创建属性。 
创建后,该属性的显示字段类型将为 计算。后续 无法修改其类型( 时间区间、 时间起始 时间截止),但 可选择不同的起始或结束日期属性。

请注意: 以下场景支持"自某时起"和"至某时止"属性:

显示时长值时,预期行为如下:

  • 对于无时间戳的日期属性,计算中使用的默认时间为所选日期的协调世界时凌晨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 函数。
  • 若自定义公式中的数值属性存在空值或未赋值,计算将中止且计算属性值为空。即使公式包含常量数值,该值仍会保持空值。此时可使用if和 is_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. 要预览公式输出结果,请点击测试公式
  12. 点击创建属性

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

自定义方程语法

  • 字面量语法:使用字面量数据可在方程中添加文本字符串、数字及真/假值。字符串、数字、布尔值和日期常量可按以下方式格式化:
    • 字符串字面量:用引号包围的文本。可使用单引号('常量')或双引号("常量")表示。

    • 数字字面量:无引号的数字。常量数字可为任意实数,支持小数点表示法。例如1005和1.5589均为有效常量数字。

    • 布尔字面量:布尔常量可取值为truefalse

    • 日期字面量:以毫秒为单位表示的日期。例如1698508800000
  • 属性语法:可在自定义方程中包含同一对象的其他属性。
    • 若属性被插入 编辑器,系统将自动将其格式化并作为方程的一部分进行验证。
    • 若选择手动输入或粘贴属性至编辑器,应采用[properties. {propertyInternalName}]格式。例如添加 内部 值为 Test_scoreTest score 属性 时,需输入 [properties.Test_score]
    • 在方程式中使用枚举属性 (如下拉选择框、单选按钮)时,其值被视为字符串,必须用双引号包裹(例如"订阅者"),同时需使用属性选项的内部名称(例如"预约已安排")。
    • 在公式中使用日期属性时,值以UTC午夜为基准存储为毫秒数。
    • 在公式中使用日期时间属性时,值以UTC纪元时间(毫秒制)存储。该值将根据用户时区显示,因此不同时区的用户将看到不同数值。

运算符

方程式中可使用运算符更新、评估或比较常量与属性值。多个运算符遵循PEMDAS运算优先级规则。根据数据类型,自定义方程式可包含以下运算符:

运算符 描述
+ 加法运算(数字或字符串)。返回数字结果。
- 减去数字。返回一个数字。
* 数字相乘。返回一个数字。
/ 数字除法。返回一个数字。
< 检查一个值是否小于另一个值。支持数字属性或常量。返回布尔值。
> 检查一个值是否大于另一个值。支持数字属性或常量。返回布尔值。
<= 检查一个值是否小于或等于另一个值。支持数字属性或常量。返回布尔值。
>= 检查一个值是否大于或等于另一个值。支持数字属性或常量。返回布尔值。
! 检查所有值是否均为假。返回布尔值。
=== 检查一个值是否等于另一个值。支持数字和字符串。返回布尔值。
!= 检查值是否不等于另一个值。支持数字和字符串类型。返回布尔值。
or|| 检查两个值中是否至少有一个为真。返回布尔值。
and&& 检查两个值是否均为真。返回布尔值。

函数

您可在自定义公式中使用函数来计算值并执行数据操作。根据所用数据类型,可在自定义公式中包含以下函数:

函数 参数 示例

abs

获取数字的绝对值。返回一个数字。

abs(number)

number:要获取绝对值的数值。

abs(-100)= 100

add_time

将指定时间以指定单位添加至基准时间。

add_time(基准时间, 添加时间, 单位)

基准时间:基准时间。

要添加的时间:要添加到基准时间上的时间量。

单位:表示添加时间的单位。可选项包括分钟小时月或

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

concatenate

将最多100个字符串组合为一个值。返回字符串。

concatenate("参数1", "参数2")

arg1:arg2将被追加的字符串。

arg2:要附加到 arg1 的字符串。

concatenate("示例", " 测试")= "示例 测试"

contains

判断字符串是否包含另一个字符串(区分大小写)。返回布尔值。 

contains(文本, 子字符串)

text:要检查子字符串的字符串或文本属性。

子字符串:文本应包含的字符串。

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

contains("HubSpot", "Spot")

货币小数位数

获取货币的位数。返回一个数字。

货币小数位数(货币)

货币:要计算小数位数的货币字符串。

currency_decimal_places("USD")

dated_exchange_rate

获取指定时间点的汇率值。返回一个数字。 

dated_exchange_rate(货币, 日期)

货币:用于计算特定日期汇率的货币字符串(例如"USD")。

date:用于计算汇率的日期时间属性。

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

exchange_rate

获取最新汇率。返回一个数字。

exchange_rate(货币)

货币:要计算汇率的货币字符串。

exchange_rate("USD")

欧拉常数

返回欧拉常数值。

euler()

euler()= 2.71828

if

设置条件表达式。

if(条件, 参数2)if(条件, 参数2, 参数3)

条件:决定计算结果的布尔表达式。

arg2:布尔值、数字或字符串,当条件满足时即为计算结果。 

arg3(可选):条件未满足时的计算值。若包含此参数,其类型必须与arg2相同。若未使用,则条件未满足时值为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(text)

文本:要转换为小写的字符串或文本属性值。

lowercase("heLLo")= "hello"


lowercase([properties.test])

max

获取两个数字的最大值。返回一个数字。 

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(待舍入数值, 精度)

待舍入数值:需要向下舍入的数值或数值属性。

precision:四舍五入后的有效小数位数。

round_down(4.353, 1)= 4.3

round_nearest

将数字四舍五入至指定精度。返回一个数字。

round_nearest(待四舍五入的数值, 精度)

待四舍五入的数值:需要四舍五入的数值或数值属性。

precision:要四舍五入的小数位数。

round_nearest(4.32, 1)= 4.3

round_up

将数值向上舍入至指定精度。返回一个数值。

round_up(待四舍五入的数值, 精度)

待四舍五入的数值:需要向上舍入的数值或数值属性。

precision:四舍五入后的有效小数位数。

round_up(4.353, 1)= 4.4

sqrt

获取数的平方根。返回一个数。

sqrt(number)

number:要求平方根的数值。

sqrt(144)= 12

starts_with

判断字符串是否以另一个字符串开头(区分大小写)。返回布尔值。

starts_with(文本, 子字符串)

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(基准时间, 减去时间, 单位)

基准时间:基准时间。

要减去的时间:从基准时间中减去的时间量。

单位:表示要减去的时间单位。选项包括分钟小时月或

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

time_between

获取两个日期之间的时间差。返回一个数字

time_between(date1, date2)

date1:起始日期时间属性。

date2:结束日期时间属性。

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

大写

将所有字符转换为大写。返回字符串。

uppercase(text)

text:要转换为大写的字符串或文本属性。

uppercase("hello")= "HELLO"

year

获取指定日期的数字年份。返回一个数字。

year(date)

日期:用于计算年份的日期时间属性。

year([properties.closedate])

查看自定义公式示例

以下是基于常见用例的示例公式。

使用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)

请注意:建议在输入属性名称和描述时保持具体明确,以便用户知晓所计算的时间单位(如小时或天数)。

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. 点击创建属性

创建计算属性:

  1. 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标
  2. 在左侧边栏菜单中导航至"属性"。

  3. 点击“选择对象”下拉菜单,选择“交易属性”。
  4. 点击创建属性

  5. 属性标签文本框中输入“计算折扣百分比”。 
  6. 点击字段类型下拉菜单,选择计算
  7. 点击数字格式下拉菜单,选择百分比
  8. 计算公式文本框中输入:(计算折扣金额 / (计算折扣金额 + 金额))。您也可点击生成公式让Breeze 自动生成。
  9. 点击创建属性

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

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助