创建计算和卷积属性
上次更新时间: 2026年1月30日
可与以下任何订阅一起使用,除非另有说明:
-
营销 Hub Professional, Enterprise
-
销售 Hub Professional, Enterprise
-
Service Hub Professional, Enterprise
-
Data Hub Professional
-
内容 Hub Professional, Enterprise
-
智能 CRM Professional, Enterprise
-
Commerce Hub Professional, Enterprise
您可以创建基于其他属性计算结果填充数据的属性。通过汇总属性,可自动计算关联记录中属性的最小值、最大值、计数、总和或平均值。借助计算属性,可基于属性值之间的时间间隔、截止时间或起始时间设置公式,或根据对象属性创建自定义公式。
请注意:您的账户可能为每个对象使用个性化名称(例如使用 account 代替 company)。本文以 HubSpot 默认名称指代对象。
例如,您可以创建:
- 一个基于自定义公式计算新客户获取成本的公司属性。
- 联系人属性:计算联系人关联交易的平均金额。
- 一个交易属性,用于计算交易开启后的时长。
- 发票/订阅/付款属性:计算折扣后实际利润金额。
根据您的 HubSpot 订阅类型,可创建的计算属性数量存在限制。
基于关联记录属性创建汇总属性
可为对象创建基于其关联记录特定属性值计算的属性。既可计算该对象所有关联记录的汇总值,也可针对特定关联标签(包括同对象关联)进行计算。
例如:可创建一个交易属性,统计标记为"决策者"的 关联联系人记录的销售活动总数。
- 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标。
-
在左侧边栏菜单中导航至"属性"。
-
点击"选择对象"下拉菜单,选择[对象]属性以创建该对象的属性。
- 点击创建属性。
- 输入属性的基本信息。
- 点击字段类型下拉菜单,选择汇总。
- 点击“汇总类型”下拉菜单,选择以下类型之一:
- 最小值:显示所选对象关联记录中选定数字属性的最小值。
- 最大值:显示所选对象所有关联记录中选定数字属性的最大值。
- 计数:统计所选对象关联记录中具有所选数字属性值的总条目数。
- 求和:计算所选对象所有关联记录中选定数值属性的总和。
- 平均值:计算所选对象所有关联记录中选定数字属性的平均值。
- 点击数字格式下拉菜单,从以下格式中选择:格式化 数字、未格式化数字、货币、百分比或 时长。此设置将配置该属性的数值格式。
- 若为交易属性选择货币格式,该属性将默认采用账户的公司货币。
- 若需使用各交易记录的货币,请勾选" 使用记录货币而非公司货币"复选框。使用记录货币仅影响数值显示方式,不会自动应用汇率转换。
- 选择关联对象和关联记录属性作为计算基础。
- 点击"选择关联标签",勾选特定标签以仅基于该标签的记录进行计算。
- 点击添加条件可设置记录必须满足的可选条件(例如:当近期交易金额>1000且交易概率 ≥80时计算属性)。每个汇总属性最多可配置50个数字型和枚举型字段条件。
- 在第一个下拉菜单中选择属性。
- 在第二个下拉菜单中,选择运算符以比较首个属性的数值与数字或另一个属性的数值。
- 在第三个下拉菜单中,选择属性或输入数值作为 与首个属性进行比较的基准 。
- 点击保存。
- 点击创建。创建后,该属性的显示字段类型将为汇总。
请注意:原始时长值以毫秒为单位存储。若在其他HubSpot工具(如筛选器、计算属性公式)中使用时长计算属性,可能需要采用毫秒值。
创建时间间隔、时间间隔或剩余时间计算属性
您可以创建计算两个日期之间时间间隔的属性,或根据日期或日期时间选择器属性的值,追踪距某日期已过去或剩余的时间。时间间隔属性仅支持同一对象的属性。
例如:
- 创建"时间间隔"属性以计算工单分配给所有者至工单关闭之间的时间。
- 创建"自开启以来时间"属性以追踪交易开启时长。
- 创建"距关闭时间"属性,追踪客户设定的交易关闭日期与今日的剩余天数。
若需创建基于今日日期而非属性值显示相对时间的属性,请参阅如何创建相对时间日期/日期时间选择器属性。您也可通过自定义公式创建固定时间属性。
创建时间间隔、自时间 起或至时间计算属性:
- 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标。
-
在左侧边栏菜单中导航至"属性"。
-
点击"选择对象"下拉菜单,选择[对象]属性以创建该对象的属性。
- 输入属性的基本信息。
- 点击字段类型下拉菜单,选择计算。
- 点击计算属性类型下拉菜单,选择类型并设置计算规则:
- 时间间隔:选择起始日期和结束日期属性 。
- 自某时起:选择日期/日期时间选择器 属性作为起始日期。结束日期将始终为当日日期。
- 剩余时间:选择日期/日期时间选择器 属性作为结束日期。起始日期始终为当日日期。
- 仅限时间区间属性:点击添加条件 可添加计算所需满足的可选条件。
- 点击创建属性。
显示时长值时,预期行为如下:
- 对于无时间戳的日期属性,计算中使用的默认时间为所选日期的协调世界时凌晨12:00。
- 显示值将根据特定阈值以秒、分钟、小时、天、月或年为单位呈现。单位阈值如下:
- 2.5年及以上以年为单位显示。
- 3个月及以上显示为月。
- 1天及以上以天为单位显示。
- 2.5小时及以上以小时显示。
- 2.5分钟及以上以分钟显示。
- 2.5分钟以下将以秒为单位显示。

请注意:在HubSpot系统中,"时间间隔"和"平均值"属性类型的原始值以毫秒为单位存储。若包含这些值的公式计算结果高于预期,请使用毫秒转换器将其转换为所需时间单位。
创建自定义公式计算属性
您还可创建基于自定义规则计算值的属性。自定义公式仅限于在创建新属性的同一对象内设置数值属性。例如,可创建公式计算企业最近交易金额(最近交易金额)与贵司联系该企业次数(联系次数)的比值。
您可使用算术运算符、比较运算符、逻辑运算符、条件语句及其他函数构建自定义公式。这些公式可返回数字、布尔值、字符串、日期或日期时间值。了解可用运算符、函数 及公式格式规范,也可查阅常用公式示例。
创建自定义公式计算属性步骤:
- 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标。
-
在左侧边栏菜单中导航至"属性"。
-
点击"选择对象"下拉菜单,选择[对象]属性以创建该对象的属性。
- 输入属性的基本信息。
- 点击字段类型下拉菜单,选择计算。
- 点击计算属性类型下拉菜单,选择自定义公式。
- 点击输出类型下拉菜单,选择计算将返回的输出类型。可选项包括:数字、布尔值、字符串、日期或 日期时间。
请注意:所选输出类型必须与编辑器右上角显示的输出类型匹配,否则无法创建属性。对于返回日期的属性,可选择数字或日期输出类型,该选择决定值的显示方式(即数字类型显示毫秒级日期,日期类型显示格式化日期)。
- 若选择数字输出类型:
- 点击数字格式下拉菜单,选择属性值的格式化方式。可选项包括:格式化数字、未格式化数字、货币、百分比或 时长。
- 若为交易属性选择货币格式,该属性默认采用账户的公司货币 。如需使用每条交易记录的货币,请勾选" 使用记录货币而非公司货币"复选框。
- 使用记录货币仅影响数值显示方式,不会自动应用汇率。若需添加汇率,可在公式中包含
exchange_rate或dated_exchange_rate函数。 - 若自定义公式中的数值属性存在空值或未赋值,计算将中止且计算属性值为空。即使公式包含常量数值,该值仍会保持空值。此时可使用
if和is_known函数将值设为0。
- 在编辑器中,通过插入、输入或粘贴函数与属性来构建自定义公式。了解自定义计算公式语法 详情。插入公式元素的方法 :
- 点击“插入”下拉菜单。
- 要向方程式插入函数,请选择“函数”,然后选取所需函数。
- 要向公式插入属性,请选择“属性”,然后选取所需属性。创建自定义公式时,仅可使用与当前对象属性相同的属性进行组合。
- 若公式存在错误,请点击编辑器上方的[x]问题图标查看错误原因。当公式存在未解决错误时,将无法创建属性。了解更多公式格式设置方法。
- 要预览公式输出效果,请点击测试公式。
- 点击创建属性。

请注意:计算公式中最多可嵌套70个左括号(例如(((1+2)+3)+4)的嵌套层级为4)。
使用AI创建自定义计算属性
- 在 HubSpot 帐户中,单击顶部导航栏中的 settings“设置”图标。
-
在左侧边栏菜单中导航至"属性"。
-
点击"选择对象"下拉菜单,选择[对象]属性以创建该对象的属性。
- 点击创建属性。
- 输入属性的基本信息。
- 点击字段类型下拉菜单并选择计算。
- 在公式文本框下方点击生成公式。
- 在弹出框中:
- 将鼠标悬停在示例链接上查看推荐提示。
- 在“您希望该属性为您计算什么?”文本框中输入提示语。
- 点击生成。
- 检查生成的公式,如有需要可进行修改。
- 点击“输出类型”下拉菜单,选择与公式文本框中显示的值(例如字符串)相匹配的类型。
- 要预览公式输出结果,请点击测试公式。
- 点击创建属性。

自定义方程语法
- 字面量语法:使用字面量数据可在方程中添加文本字符串、数字及真/假值。字符串、数字、布尔值和日期常量可按以下方式格式化:
-
字符串字面量:用引号包围的文本。可使用单引号(
'常量')或双引号("常量")表示。 -
数字字面量:无引号的数字。常量数字可为任意实数,支持小数点表示法。例如
1005和1.5589均为有效常量数字。 -
布尔字面量:布尔常量可取值为
true或false。 - 日期字面量:以毫秒为单位表示的日期。例如
1698508800000。
-
- 属性语法:可在自定义方程中包含同一对象的其他属性。
- 若属性被插入 编辑器,系统将自动将其格式化并作为方程的一部分进行验证。
- 若选择手动输入或粘贴属性至编辑器,应采用
[properties.{propertyInternalName}]格式。例如添加 内部 值为 Test_score 的 Test score 属性 时,需输入[properties.Test_score]。 - 在方程式中使用枚举属性 (如下拉选择框、单选按钮)时,其值被视为字符串,必须用双引号包裹(例如
"订阅者"),同时需使用属性选项的内部名称(例如"预约已安排")。 - 在公式中使用日期属性时,值以UTC午夜为基准存储为毫秒数。
- 在公式中使用日期时间属性时,值以UTC纪元时间(毫秒制)存储。该值将根据用户时区显示,因此不同时区的用户将看到不同数值。
运算符
方程式中可使用运算符更新、评估或比较常量与属性值。多个运算符遵循PEMDAS运算优先级规则。根据数据类型,自定义方程式可包含以下运算符:
| 运算符 | 描述 |
+ |
加法运算(数字或字符串)。返回数字结果。 |
- |
减去数字。返回一个数字。 |
* |
数字相乘。返回一个数字。 |
/ |
数字除法。返回一个数字。 |
< |
检查一个值是否小于另一个值。支持数字属性或常量。返回布尔值。 |
> |
检查一个值是否大于另一个值。支持数字属性或常量。返回布尔值。 |
<= |
检查一个值是否小于或等于另一个值。支持数字属性或常量。返回布尔值。 |
>= |
检查一个值是否大于或等于另一个值。支持数字属性或常量。返回布尔值。 |
! |
检查所有值是否均为假。返回布尔值。 |
=或== |
检查一个值是否等于另一个值。支持数字和字符串。返回布尔值。 |
!= |
检查值是否不等于另一个值。支持数字和字符串类型。返回布尔值。 |
or或|| |
检查两个值中是否至少有一个为真。返回布尔值。 |
and或&& |
检查两个值是否均为真。返回布尔值。 |
函数
您可在自定义公式中使用函数来计算值并执行数据操作。根据所用数据类型,可在自定义公式中包含以下函数:
| 函数 | 参数 | 示例 |
|
获取数字的绝对值。返回一个数字。 |
number:要获取绝对值的数值。 |
|
|
|
|
|
|
将最多100个字符串组合为一个值。返回字符串。 |
arg1:arg2将被追加的字符串。 arg2:要附加到 arg1 的字符串。 |
|
|
判断字符串是否包含另一个字符串(区分大小写)。返回布尔值。 |
text:要检查子字符串的字符串或文本属性。 子字符串:文本应包含的字符串。 |
contains("HubSpot", "Spot") |
|
获取货币的位数。返回一个数字。 |
货币:要计算小数位数的货币字符串。 |
|
|
获取指定时间点的汇率值。返回一个数字。 |
货币:用于计算特定日期汇率的货币字符串(例如 date:用于计算汇率的日期时间属性。 |
|
|
获取最新汇率。返回一个数字。 |
货币:要计算汇率的货币字符串。 |
|
|
|
|
|
|
设置条件表达式。 |
条件:决定计算结果的布尔表达式。 arg2:布尔值、数字或字符串,当条件满足时即为计算结果。 arg3(可选):条件未满足时的计算值。若包含此参数,其类型必须 |
|
|
判断令牌是否已知该值。返回布尔值。 |
property:要检查其值的属性。 |
|
|
获取令牌上次更新的日期。返回以毫秒为单位的时间戳字符串。 |
属性:要检查其最近更新日期的属性。 |
|
|
将所有字符转换为小写。返回字符串。 |
文本:要转换为小写的字符串或文本属性值。 |
|
|
获取两个数字的最大值。返回一个数字。 |
arg1:第一个数字或数字属性。 arg2:第二个数字或数字属性。 |
|
|
获取两个数字中的最小值。返回一个数字。 |
arg1:第一个数字或数字属性。 arg2:第二个数字或数字属性。 |
|
|
获取给定日期的数字月份。返回一个数字。 |
日期:用于计算月份的日期时间属性。 |
|
|
将数字转换为字符串。返回字符串。 |
number_to_convert:要转换为字符串的数字或数字属性。 |
|
|
获取管道阶段的概率。返回一个数字。 |
pipeline:要计算概率的管道名称。 |
|
|
将一个数值提升到另一个数值的幂次。返回一个数值。 |
base:底数。 exponent:要将基数提升的指数值。 |
|
|
将数值向下舍入至指定精度。返回一个数值。 |
待舍入数值:需要向下舍入的数值或数值属性。 precision:四舍五入后的有效小数位数。 |
|
|
将数字四舍五入至指定精度。返回一个数字。 |
待四舍五入的数值:需要四舍五入的数值或数值属性。 precision:要四舍五入的小数位数。 |
|
|
将数值向上舍入至指定精度。返回一个数值。 |
待四舍五入的数值:需要向上舍入的数值或数值属性。 precision:四舍五入后的有效小数位数。 |
|
|
获取数的平方根。返回一个数。 |
number:要求平方根的数值。 |
|
|
判断字符串是否以另一个字符串开头(区分大小写)。返回布尔值。 |
text:要检查是否包含子字符串的字符串或文本属性。 substring:文本应以该字符串开头的子字符串。 |
|
|
|
|
|
|
将字符串转换为数字。返回一个数字。 |
string_to_convert:要转换为数字的字符串或文本属性。 |
|
|
|
|
subtract_time(1699320015000, 1, "second") = 1699320014000 |
|
获取两个日期之间的时间差。返回一个数字。 |
date1:起始日期时间属性。 date2:结束日期时间属性。 |
|
|
将所有字符转换为大写。返回字符串。 |
text:要转换为大写的字符串或文本属性。 |
|
|
获取指定日期的数字年份。返回一个数字。 |
日期:用于计算年份的日期时间属性。 |
|
查看自定义公式示例
以下是基于常见用例的示例公式。
使用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 自动生成。 - 点击创建属性。

