跳到内容

自定义公式函数

上次更新时间: 二月 13, 2025

除非另有说明,否则适用于以下任何订阅

Operations Hub   Professional , Enterprise

如果要在工作流程中使用自定义公式来格式化数据,可以使用带有所登记记录的属性值或先前操作输出的函数来创建复杂的公式。

查看下面的不同功能,以确定使用哪种功能:

功能 说明 示例
腹肌 读取一个数字的绝对值。您可以使用此函数来确保一个数字是正数。
  • 示例公式: abs([数字或数字属性])
    • 例如:abs(-10)
    • 输出示例: 10
增加 将一个数值加到另一个数值上。此功能与 + 运算符相同。与以下操作一起使用:
  • number:初始数值。
  • 要添加的数字:要添加到初始数值中的数字。
  • 示例公式:add(number, number to add)
    • 例如add(5, 10)
    • 输出示例: 15

或者,您也可以使用

  • 示例公式:number + number to add
    • 例如5+10
    • 输出示例: 15
连接 合并多个字符串值。此功能只有在自定义模式下使用格式化数据操作时可用。
  • 公式示例:concat([string 1], " ", [string 2])
    • 示例: concat([company name], " ", [MonthYear])
    • 示例输出:HubSpot 2006 年 6 月
大写 将字符串值的第一个字母大写。第一个字符大写,其他字母小写。输入中的其他单词的第一个字母不会大写
  • 示例公式:capitalize([string])
    • 例如capitalize([firstname])
    • 输出示例: 亨利
剪切 剪切一个或多个字符,从数值中删除字符串。此函数可用于匹配和剪切字符串的特定部分。参数指定应删除的字符串部分。可与以下函数一起使用:
  • source:要删除字符的源字符串。
  • characters_to_cut:要删除的特定字符。此格式区分大小写。
  • 计算公式 cut(source, characters to cut)
    • 例如 cut([phone], "-")
    • 输出示例:80081234567


日期时间格式

请注意:该公式已被弃用,取而代之的是下面的format_datetime 函数。使用此函数的操作将继续有效,但今后应使用新函数。

格式化日期时间 将时间戳转换为人性化的格式。将时间戳或属性与以下参数一起包含,以配置其格式:
  • format:要使用的格式。值包括'short','medium','long','full' 。也可以使用Unicode LDML 模式指定自定义格式。
  • timeZone:以IANA TZDB格式输出数据的时区。默认情况下,返回 UTC 时间。
  • locale:本地感知格式使用的本地语言。
  • 计算公式 format_datetime(date, format, timeZone, locale)
    • 例如 format_datetime([closedate], 'medium', 'America/New_York, 'de-DE')
    • 输出示例:08.02.2024, 17:09:49
鸿沟 除以一个数字。此功能可替代 / 运算符。可与以下命令一起使用:
  • number:要除以的数字。
  • 除数:除法运算中要除以的数字。
  • 计算公式divide(number, divisor)
    • 例如divide (8, 4)
    • 输出示例:2

或者,您也可以使用

  • 计算公式number/divisor
    • 例如8/4
    • 输出示例:2
可分 测试一个数字是否能被整除。如果没有余数,函数的返回值为 true。有余数时,此函数的值为假。与以下函数一起使用:
  • number:要除的数。
  • divisor:除法运算中要除以的数字。
  • 计算公式divisible(number, divisor)
    • 例如divisible (5,2)
    • 示例输出:false
加入 将两个或多个字符串合并为一个结果字符串,每个值之间使用分隔符。此功能只有在自定义模式下使用格式化数据操作时可用。

与以下操作一起使用:
  • 分隔符:在每个项目之间插入的分隔符字符串。
  • items:要合并的字符串的任意数目。
  • 计算公式join(delimiter, items)
    • 例如join("-", "A", "B", "C")
    • 输出示例:A-B-C
左侧 从字符串值的开头返回字符串值中的字符子串。此功能只有在自定义模式下使用格式化数据操作时可用。
  • 计算公式left(string, length)
    • 例如left("Maria", "1")
    • 输出示例:M


长度 返回字符串中的字符数。
  • 计算公式length(string)
    • 例如left("Hello World!")
    • 输出示例:12
降低 将字符串中的所有字符转换为小写字母。
  • 计算公式lower([string])
    • 例如lower(["HELLO WORLD"])
    • 输出示例:你好世界
中间 返回字符串值中的字符子串。此功能只有在自定义模式下使用格式化数据操作时可用。
  • 计算公式mid(string, start-index, length)
    • 例如join("abc123", 2, 2)
    • 输出示例:c1
减去时间 从日期/时间对象中减去一定量的时间。与以下功能一起使用:
  • datetime:要从中减去时间的日期/时间对象。
  • diff:要减去的时间量。
  • timeunit:要减去的时间单位。可以使用以下单位:
    • 分钟
    • 小时
    • 半日
  • 计算公式minus_time(datetime, diff, timeunit)
    • 例如minus_time([closedate], 2, "days")
    • 输出示例:04/11/2020
乘法器 将一个数值与一个数字相乘。此函数可替代 * 操作符。可与以下操作一起使用:
  • number:要乘以的数值。
  • multiplier: 要乘以的数值。
  • 计算公式multipler(number, multipler)
    • 例如: multiplier(5, 3)
    • 输出示例: 15

或者,您也可以使用

  • 计算公式number*multipler
    • 例如: 5*3
    • 输出示例: 15
编号 将字符串转换为数字。
  • 计算公式number(string, default?)
    • 例如left("36")
    • 输出示例:36
加时间 为日期/时间对象添加时间量。与下列内容一起使用:
  • datetime:要添加时间的日期/时间对象。
  • diff:要添加的时间量。
  • timeunit:要添加的时间单位。
  • 计算公式plus_time(datetime, diff, timeunit)
    • 例如plus_time([closedate], 2, "days")
    • 输出示例:06/11/2020


随机数 在一定范围内生成随机数。

使用此功能生成的号码完全随机,并且可能重复。例如,如果您使用的范围是 1 到 3,并注册了三个联系人,您可能不会得到三个唯一的数字。

最小和最大数字都包含在范围内。在设置范围时,您还可以使用 0 和负数。
  • 计算公式randomNumber(minimum, maximum)
    • 例如randomNumber(1, 3)
    • 输出示例:1 或 2
顶替 用不同的字符串替换子串的所有实例。与下列内容一起使用
  • string:要搜索和替换的字符串。
  • old:要替换的子字符串。
  • new:替换后的字符串。
  • count:要替换的子字符串的个数。如果未提供,将替换所有子字符串
  • 计算公式replace(string, old, new, count)
    • 例如replace( "Hello world!", "Hello", "Hi", 1)
    • 输出示例嗨,世界!
从字符串值的末尾返回字符串值中的字符子串。此功能只有在自定义模式下使用格式化数据操作时可用。
  • 计算公式right(string, length)
    • 例如right("abc123", 3)
    • 输出示例:123
regex_replace 搜索 regex 模式并用提供的字符串替换。与以下参数一起使用:
  • original_string: 要搜索的原始字符串。
  • pattern: 要匹配的 regex模式 。有关 RE2 语法的信息,请参见此处
  • replacement_string:用字符串替换与模式匹配的字符。
  • 计算公式 regex_replace(original_string, pattern, replacement_string)
    • 例如 regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • 输出示例:contactus
根基 计算一个数字的平方根。可指定要计算的 N 次方根。与以下命令一起使用:
  • number:要取根的数字。可选择指定要计算的 N 次根
  • nthRoot: 要计算的第 n 次根。如果未指定,将计算平方根。
  • 计算公式root(number, nthRoot)
    • 例如root(625, 4)
    • 输出示例:5
一轮 将数字四舍五入到指定的小数位。与以下命令一起使用:
  • 精度:四舍五入到的小数。
  • 舍入方法:向上或向下舍入到最接近的整数。 可以使用以下舍入方法:
    • 普通
    • 上限
    • 下限
  • 计算公式round(number, precision, rounding method)
    • 例如round(52.5, 0, 'floor')
    • 输出示例:52
标签 删除 SGML/XML 标记,并用一个空格替换相邻的空白。该过滤器可用于删除变量中的任何 HTML 标记。
  • 计算公式striptags([string])
    • 例如striptags(<div><p>Potato</p></div>)
    • 输出示例:马铃薯
标题 将文本改为标题大小写。结果字符串中的每个单词将以大写字母开头,其余所有字符均为小写。
  • 计算公式title([string])
    • 例如title("cheddar CHEESE")
    • 输出示例:切达干酪
内饰 删除字符串前部和尾部的空白。
  • 计算公式trim([string])
    • 例如: trim(" peach ")
    • 输出示例:桃子
unixtimestamp 将日期/时间对象转换为 Unix 时间戳。
  • 计算公式unixtimestamp([dateteime])
    • 例如unixtimesstamp([closedate])
    • 输出示例: 1652863824
鞋帮 将所有字符改为大写。
  • 计算公式upper([string])
    • 例如upper("teatime")
    • 输出示例:TEATIME
urlencode 使用 UTF-8 格式对字符串进行 Escape 和 URL 编码。
  • 计算公式urlencode([string])
    • 例如urlencode("hi there")
    • 输出示例: hi%20there
这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助