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

在工作流程中格式化数据时使用自定义公式函数

上次更新时间： 2026年4月13日

可与以下任何订阅一起使用，除非另有说明：

如果您正在工作流中使用自定义公式对数据进行格式化，可以使用来自已注册记录的属性值或先前操作的输出结果来构建复杂公式。 

这些函数不适用于计算属性。如果您想了解计算属性的运算符、函数等内容，请参阅如何创建自定义方程式计算属性。 

请查看以下不同函数，以确定应使用哪一种： 

函数 描述 示例
abs 获取一个数的绝对值。您可以使用此函数来确保该数为正数。
  • 示例公式： abs([数字或数字属性])
    • 示例：abs(-10) 
    • 示例输出：10
add 将一个数值加到另一个数值上。此函数与 + 运算符功能相同。请配合以下内容使用： 
  • number：运算的初始数值。
  • 待加数值：要加到初始数值上的数值。 
  • 示例公式：add(数字, 待加数字)
    • 示例：add(5, 10)
    • 示例输出：15

此外，您还可以使用：

  • 示例公式：number + number to add
    • 示例：5+10
    • 示例输出：15
concat 合并多个字符串值。此函数仅在“自定义”模式下使用“格式化数据”操作时可用。 
  • 示例公式：concat([字符串 1], " ", [字符串 2]) 
    • 示例： concat([公司名称], " ", [月年])
    • 示例输出：HubSpot 2006年6月
首字母大写 将字符串值的首字母大写。第一个字符将变为大写，其余所有字母将变为小写。输入中的其他单词的首字母不会被大写
  • 示例公式：capitalize([字符串])
    • 示例：capitalize([firstname])
    • 示例输出：Henry
截取 截取一个或多个字符以从值中移除字符串。此函数可用于匹配并截取字符串的特定部分。参数指定应被移除的字符串部分。请配合以下内容使用： 
  • source：要从中删除字符的源字符串。 
  • characters_to_cut：要删除的特定字符。此格式区分大小写。 
  • 公式： cut(源，要截取的字符)
    • 示例： cut([phone], "-")
    • 示例输出：80081234567 
datetimeformat

请注意：此公式已弃用，并被下方的format_datetime函数取代。使用此函数的操作仍可正常运行，但今后应使用新函数。

  
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')
    • 示例输出： 2024年2月8日, 17:09:49
divide 对数字进行除法运算。此函数是 / 运算符的替代方案。请与以下内容配合使用： 
  • number：待除数。 
  • 除数：用于除法的被除数。 
  • 公式：divide(number, divisor)
    • 示例： divide (8, 4)
    • 示例输出：2

此外，您还可以使用： 

  • 公式：数字/除数
    • 示例： 8/4
    • 示例输出：2
可除性 测试一个数是否能被整除。当没有余数时，该函数返回 true；当有余数时，该函数返回 false。请配合以下内容使用： 
  • number：待除数。 
  • 除数：用于除法的被除数。 
  • 公式：divisible(number, divisor)
    • 示例： 可被 (5,2) 整除
    • 示例输出：false
join 将两个或多个字符串合并为一个结果字符串，并在每个值之间使用分隔符。此功能仅在“自定义”模式下使用“格式化数据”操作时可用。 

与以下操作配合使用： 
  • 分隔符：插入在每个项目之间的分隔字符串。
  • 项：待合并的任意数量的字符串。 
  • 公式：join(分隔符, 项目)
    • 示例： join("-", "A", "B", "C")
    • 示例输出：A-B-C
left 返回字符串值中从起始位置开始的一段字符子串。此函数仅在“自定义”模式下使用“格式化数据”操作时可用。
  • 公式：left(字符串, 长度)
    • 示例： left("Maria", "1")
    • 示例输出：M
length 返回字符串中的字符数。
  • 公式：length(字符串)
    • 示例： left("Hello World!")
    • 示例输出：12
lower 将字符串中的所有字符转换为小写字母。
  • 公式：lower([字符串])
    • 示例： lower(["HELLO WORLD"])
    • 示例输出：hello world
mid 返回字符串值中的子字符串。此函数仅在“自定义”模式下使用“格式化数据”操作时可用。
  • 公式：mid(字符串, 起始索引, 长度)
    • 示例： join("abc123", 2, 2)
    • 示例输出：c1
minus_time 从日期/时间对象中减去指定时间。请与以下操作配合使用： 
  • datetime：要从中减去时间的日期/时间对象。
  • diff：要减去的时间量。 
  • timeunit：要减去的时间单位。可使用以下选项： 
    • seconds
    • 分钟
    • 小时
    • 半天
    • 天
    • 周
    • 月
    • 年
  • 公式：minus_time(日期时间, 时间差, 时间单位)
    • 示例： minus_time([closedate], 2, "days")
    • 示例输出：2020年4月11日
乘数 将一个值乘以一个数字。此函数是 * 运算符的替代方案。请与以下内容配合使用： 
  • number：待乘的数值。
  • 乘数： 用于乘以的数值 。 
  • 公式：multipler(number, multipler)
    • 示例：multiplier(5, 3) 
    • 示例输出：15

此外，您还可以使用：

  • 公式：数字*倍数
    • 示例： 5*3 
    • 示例输出：15
number 将字符串转换为数字。
  • 公式：number(字符串, 默认值?)
    • 示例： left("36")
    • 示例输出：36
plus_time 向日期/时间对象添加一定时间。与以下内容配合使用： 
  • datetime：要添加时间的目标日期/时间对象。
  • diff：要添加的时间量。 
  • timeunit：要添加的时间单位。 
  • 公式：plus_time(datetime, diff, timeunit)
    • 示例： plus_time([closedate], 2, "days")
    • 示例输出：2020年6月11日
随机数 在指定范围内生成一个随机数。

使用此函数生成的数字是完全随机的，可能会重复。例如，如果您使用 1 到 3 的范围并注册了 3 个联系人，您可能无法获得 3 个唯一的数字。 

范围包含最小值和最大值。设置范围时，您也可以使用 0 和负数。 
  • 公式：randomNumber(minimum, maximum)
    • 示例： randomNumber(1, 3)
    • 示例输出：1 或 2
replace 将所有子字符串替换为另一个字符串。请按以下方式使用： 
  • string：要搜索并替换的字符串。 
  • old：待替换的子字符串。 
  • new：替换后的字符串。 
  • count：要替换的子字符串的出现次数。若未提供，则替换所有子字符串
  • 公式：replace(字符串, 旧值, 新值, 次数)
    • 示例： replace( "Hello world!", "Hello", "Hi", 1)
    • 示例输出：Hi world!
right 从字符串值的末尾返回一段字符子串。此函数仅在“自定义”模式下使用“格式化数据”操作时可用。
  • 公式：right(字符串, 长度)
    • 示例： right("abc123", 3)
    • 示例输出：123
regex_replace 搜索正则表达式模式并将其替换为提供的字符串。需配合以下参数使用：
  • original_string：要进行搜索的原始字符串。
  • pattern：待匹配的正则表达式模式。有关 RE2 语法的信息可在此处查阅。
  • replacement_string：用于替换匹配到该模式的字符的字符串。
  • 公式： regex_replace(original_string, pattern, replacement_string)
    • 示例： regex_replace("contact-us-2", "[^a-zA-Z]", "")
    • 示例输出：contactus
root 计算一个数的平方根。可选地，指定要计算的第 N 次方根。使用方法如下：
  • number：要计算根号的数字。计算一个数的平方根。可选地，指定要计算的第 N 次根 
  • nthRoot： 要计算的第 n次方 根。若未指定，则默认计算平方根。 
  • 公式：root(number, nthRoot)
    • 示例： root(625, 4)
    • 示例输出：5
round 将一个数四舍五入到指定的小数位。与以下内容配合使用：
  • 精度：四舍五入的小数位数。 
  • 舍入方法：向上或向下舍入至最接近的整数。可使用以下舍入方法： 
    • common
    • ceil
    • floor
  • 公式：round(number, precision, rounding method)
    • 示例： round(52.5, 0, 'floor')
    • 示例输出：52
striptags 移除 SGML/XML 标签，并将相邻的空格替换为一个空格。此过滤器可用于从变量中移除任何 HTML 标签。
  • 公式：striptags([字符串])
    • 示例： striptags(<div><p>Potato</p></div>)
    • 示例输出：Potato
title 将文本转换为标题格式。转换后的字符串中，每个单词的首字母将大写，其余字符均为小写。
  • 公式：title([字符串])
    • 示例： title("切达奶酪")
    • 示例输出：切达奶酪
trim 从字符串中移除首尾空格。
  • 公式：trim([字符串])
    • 示例： trim(" 蜜桃 ")
    • 示例输出：peach
unixtimestamp 将日期/时间对象转换为 Unix 时间戳。
  • 公式：unixtimestamp([日期时间])
    • 示例： unixtimestamp([closedate])
    • 示例输出：1652863824
upper 将所有字符转换为大写。
  • 公式：upper([字符串])
    • 示例： upper("teatime")
    • 示例输出：TEATIME
urlencode 使用 UTF-8 格式对字符串进行转义和 URL 编码。
  • 公式：urlencode([字符串])
    • 示例： urlencode("hi there")
    • 示例输出：hi%20there
这篇文章有帮助吗？
此表单仅供记载反馈。了解如何获取 HubSpot 帮助。
目录 菜单

相关内容

New call-to-action