文档 Journey Optimizer Journey Optimizer 指南

辅助函数入门 functions

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
个性化

创建对象：

有经验的
开发人员

借助辅助函数，您可以在个性化内容中转换和操作数据。使用它们执行计算、设置数据格式、应用条件和执行各种操作，为您的客户创建动态、量身定制的体验。

这些函数利用Journey Optimizer模板语言。在此页面中了解个性化语法准则。

➡️ 在此视频中了解如何使用辅助函数

访问辅助函数

辅助函数可从个性化编辑器的功能菜单中获取：

为了便于导航，函数分为三个类别：

函数 — 数据操作和转换操作
帮助程序 — 条件逻辑和实用程序函数
运算符 — 比较运算符和逻辑运算符

要使用辅助函数：

选择一个类别以查看其子类别和可用函数
单击>图标展开子类别
单击函数旁边的+图标以将其添加到您的个性化代码
单击...图标可查看函数说明或将其添加到收藏夹。了解详情

NOTE

个性化编辑器中的可用功能和功能与历程高级表达式编辑器中的可用功能和功能不同。例如，now()函数仅在历程表达式中可用。了解详情

函数 functions-helper

聚合和数组函数

此函数返回数组中所有选定值的算术平均值。

此函数返回给定数组中元素的数量。

此函数对列表中的空值进行计数。

此函数对列表的所有元素（包括空值）进行计数

此函数从删除了重复值的数组或列表中获取值

此函数对不同值（包括空值）进行计数

此函数返回数组或列表中的第一项。

当根据给定的数值表达式按升序排序时，此函数返回数组中的前“N”项

在

此函数用于确定一个项是否是一个数组或列表的成员

包括

此函数确定一个数组或列表是否包含给定项

相交

此函数确定两个数组或列表是否至少有一个公共成员

阵列中的最后n个

此函数返回数组中的最后“N”个项（当根据给定的数值表达式按升序排序时）

最大值

此函数返回数组中所有选定值中的最大值。

最小值

此函数返回数组中所有选定值中的最小值。

不在

此函数确定一个项是否不是一个数组或列表的成员

子集

此函数确定特定数组（数组A）是否是另一个数组（数组B）的子集，即，如果数组A中的所有元素都是数组B的元素

Sum

此函数返回数组中所有选定值的总和

超集

此函数确定特定数组（数组A）是否是另一个数组（数组B）的超集，即该数组A是否包含数组B中的所有元素

日期时间函数 date-functions

添加天数

此函数按指定的天数调整给定日期，使用正值递增，使用负值递减。

添加小时

此函数按指定的小时数调整给定日期，使用正值递增，使用负值递减。

添加分钟

此函数按指定的分钟数调整给定日期，使用正值递增，使用负值递减。

添加月份

此函数按指定的月数调整给定日期，使用正值递增，使用负值递减。

添加秒数

此函数按指定的秒数调整给定日期，使用正值递增，使用负值递减。

添加年份

此函数按指定的年数调整给定日期，使用正值递增，使用负值递减。

年龄

此函数从给定日期检索年龄。

年龄（天）

此函数计算给定日期的年龄（以天为单位），即给定日期与当前日期之间经过的天数，对于未来日期为负值，对于过去日期为正值。

年龄（月）

此函数计算给定日期的年龄（以月为单位），即给定日期与当前日期之间经过的月数（对于未来日期为负，对于过去日期为正）。

比较日期

此函数将第一个输入日期与另一个输入日期进行比较。如果date1等于date2，则返回0；如果date1早于date2，则返回–1；如果date1晚于date2，则返回1。

此函数将日期时间转换为给定时区。

此函数检索当前时间（以纪元毫秒为单位）。

此函数检索两个日期之间的天数差。

此函数返回表示月中某天的数字。

此函数检索星期几。

此函数检索年中日（该年的第几天）。

此函数返回两个日期之间的秒数差。

此函数从给定时间戳中提取小时组件。

此函数从给定时间戳中提取分钟组件。

此函数从给定时间戳中提取月份组件。

此函数从给定时间戳中提取第二个组件。

此函数设置日期时间值的格式。

此函数将日期时间值格式化为其相应的语言敏感表示形式，即所需的区域设置中。

获取CurrentZoneDateTime

此函数返回包含时区信息的当前日期和时间。

此函数以小时数返回两个日期之间的差值。

此函数返回两个日期之间的分钟数差。

此函数按月返回两个日期之间的差值。

此函数为给定的日期时间设置月中日（该月的第几天）。

设置小时

此函数设置日期时间的小时。

To Date Time

此函数将字符串转换为日期。对于无效的输入，它返回纪元日期作为输出。

到UTC

此函数将日期时间转换为UTC。

截断到一天开始

此函数通过将给定日期时间设置为一天的开始并将时间设置为00:00来修改该日期。

truncatetostartofQuarter

此函数在00:00将日期时间截断为其季度的第一天（例如，1月1日、4月1日、7月1日、10月1日）。

truncateToStartOfWeek

此函数通过将给定日期时间设置为一周的开始（星期一的00:00）来修改该日期。

truncateToStartOfYear

此函数通过将该日期时间截断为一年的第一天（1月1日）00:00来修改给定的日期时间。

一年中的周

此函数返回年中周（该年中的第几周）

年差异

此函数返回两个日期之间的年数差。

映射函数 map-functions

Get

此函数用于检索给定键的映射值

键

此函数用于检索给定映射的所有键。

值

此函数检索给定映射的所有值。

数学函数 math-functions

绝对

此函数将任意数字格式化为其区分语言的表示形式。

设置数字格式

此函数将任意数字格式化为其区分语言的表示形式。

此函数返回一个0到1之间的随机值。

此函数对一个数字进行向下舍入。

此函数对一个数字进行向上舍入。

将任意数字转换为十六进制字符串。

将任意这些类型（数字、双精度、整数、长整数、浮点数、短整数、字节、布尔值、字符串）转换为整数。

目标百分比

此函数将一个数字转换为百分比。

到精度

此函数将一个数字转换为所需的精度。

目标字符串

此函数将任意数字转换为其字符串表示形式。

对象函数 object-functions

不为null

此函数用于确定是否存在对象引用

Is null

此函数用于确定对象引用是否不存在

字符串函数 string-functions

驼峰式大小写

此函数用于将字符串中每个单词的第一个字母变为大写。

字符代码位于

此函数返回字符的ASCII值，与JavaScript中的charCodeAt函数类似

Concat

此函数用于将两个字符串组合为一个

包含

此函数用于确定一个字符串是否包含指定的子字符串。

不包含

此函数用于确定一个字符串是否不包含指定的子字符串。

结尾不是

此函数用于确定一个字符串是否不以指定的子字符串结尾。

开头不是

此函数用于确定一个字符串是否不以指定的子字符串开头。

编码64

此函数用于对字符串进行编码。

结束于

此函数用于确定一个字符串是否以指定的子字符串结尾。

等于

此函数用于确定一个字符串是否不以指定的子字符串开头，且区分大小写

Equals Ignore Case

此函数用于确定一个字符串是否不以指定的子字符串开头，不区分大小写

提取电子邮件域

此函数用于提取电子邮件地址的域

设置货币格式

此函数根据在第二个参数中作为字符串传递的区域设置，将任何数字转换为相应的区分语言的货币表示形式

此函数用于获取url主机。

此函数用于获取url路径。

此函数用于获取url协议。

此函数返回第二个参数在第一个参数中第一次出现的位置。如果没有匹配项，则返回–1

IsEmpty

此函数用于检查字符串或表达式是否为空。

不为空

如果参数中的字符串不为空，则此函数返回true。

最后索引：

此函数返回第二个参数在第一个参数中最后一次出现的位置。如果没有匹配项，则返回–1。

Left trim

此函数去除字符串开头的空格。

长度

此函数用于获取字符串或表达式中的字符数。

类似

此函数用于确定一个字符串是否与指定的模式匹配

小写

此函数将字符串转换为小写字母。

蒙版

此函数用于将字符串的一部分替换为“X”字符。

匹配

此函数用于确定一个字符串是否与特定的正则表达式匹配。

MD5

此函数返回输入字符串的md5哈希值。

不等于

此函数用于确定一个字符串是否不等于指定的字符串。

不等于，忽略大小写

此函数比较两个字符串（忽略大小写）。

正则表达式组

此函数用于根据提供的正则表达式提取特定信息

替换

此函数将字符串中的给定子字符串替换为另一个子字符串。

全部替换

此函数将匹配“target”的文本的所有子字符串替换为指定的文本“replacement”字符串

Right trim

此函数去除字符串末尾的空格。

SHA256

此函数计算并返回字符串的sha256哈希。

拆分

此函数用于按给定字符拆分字符串。

开头为

此函数用于确定一个字符串是否以指定的子字符串开头。

String to date

此函数将一个字符串值转换为日期时间值。

String to integer

此函数将一个字符串值转换为一个整数值。

字符串到数字

此函数用于将字符串转换为数字。对于无效的输入，它返回相同的字符串作为输出。

子字符串

此函数返回字符串表达式在开始索引和结束索引之间的子字符串。

字首大写

此函数用于将字符串中每个单词的首字母大写。

To Bool

此函数根据类型将一个参数值转换为布尔值。

To Date Time

此函数用于将字符串转换为日期。对于无效的输入，它返回纪元日期作为输出。

To Date Time only

此函数将一个参数值转换为仅日期时间值。对于无效的输入，它返回纪元日期作为输出。

此函数去除字符串开头和结尾的空格。

此函数将一个字符串转换为大写字母。

此函数用于对url编码的字符串进行解码。

此函数用于对字符串进行url编码。

辅助程序 helper-helper

帮助程序在此页面中有详细说明。

默认回退值

此函数用于呈现默认变量

每个

此函数用于在数组上迭代

执行元数据

此帮助程序在消息呈现期间捕获自定义键值元数据，以便将其存储在运行时执行元数据对象中

如果

此函数用于定义条件块 — 如果表达式求值返回true，则呈现块

Let

此函数允许将表达式存储为变量，以便稍后在查询中使用

Unless

此函数用于定义一个条件块 — 如果表达式求值返回false，则会呈现块

替换为

此函数用于更改模板部分的求值令牌

操作员 operators-helper

算术函数 arithmetic-helper

算术函数用于对值进行基本计算。

此运算符用于求两个参数表达式的总和

此运算符用于查找两个参数表达式的商

此运算符用于查找两个参数表达式的乘积

此运算符用于查找将两个参数表达式相除后的余数

减法

此运算符计算两个表达式之间的差异

布尔函数 boolean-functions

布尔函数用于对不同元素执行布尔逻辑。

与

此运算符创建逻辑连接

或

此运算符创建逻辑分离

比较函数 comparison-functions

比较函数用于比较不同表达式和值之间的差异，从而相应地返回true或false。

等于

此操作检查值是否相等

大于

此运算符检查第一个值是否大于第二个值

大于或等于

此运算符检查第一个值是否大于或等于第二个值

小于或等于

此运算符检查第一个值是否小于或等于第二个值

不等于

此运算符检查给定的表达式是否不等于给定的值

操作说明视频 video

了解如何使用个性化辅助函数转换个性化值以及辅助函数的不同用例。

https://video.tv.adobe.com/v/3416642?captions=chi_hans&quality=12

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76