转换函数 conversion-functions

• 小数
• 布尔
• 字符串
• 整数

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

返回布尔值。

toBool("true")

toBool(1)

返回真。

toBool("this is not a boolean")

返回假。

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

toDateOnly(<integer>, <integer>, <integer>)

返回dateOnly类型值。

toDateOnly("2023-08-18")

toDateOnly("2023-08-18T00:00:00.000Z")

toDateOnly("2023-08-18T00:00:00")

所有参数都返回表示2023-08-18的dateOnly对象。

toDateOnly(#{ExperiencePlatform.ProfileFieldGroup.person.birthDate})

返回dateOnly。

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

返回​日期时间。

toDateTime("2023-08-18T23:17:59.123Z")

返回2023-08-18T23:17:59.123Z

ISO-8601字符串已包含时区信息。

toDateTime("Europe/Paris", toDateOnly("2023-08-18"))

返回2023-08-18T00:00:00.000+02:00

这通过将时区与仅用于日期的值组合来创建日期时间。 在指定的时区内，时间设置为午夜(00:00:00)。

toDateTime("UTC", toDateTimeOnly("2023-08-18T23:17:59.123"))

返回2023-08-18T23:17:59.123Z

这通过将时区应用于dateTimeOnly值（没有时区信息）来创建dateTime。

toDateTime(1560762190189)

返回2019-06-17T09:03:10.189Z

将Unix时间戳（以毫秒为单位）转换为dateTime值。

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

返回不考虑时区的日期时间。

toDateTimeOnly ("2023-08-18")

返回表示2023-08-18T00:00:00.000的日期时间

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

返回小数。

toDecimal("4.0")

返回4.0。

如果字符串表达式：接受的格式基于ISO-8601持续时间格式PnDTnHnMn.nS，天数被认为刚好是24小时。

字符串以可选符号开头，由ASCII负号或正号表示。 如果为负值，则整个期间将被否定。 ASCII字母“P”是下一个大写或小写。 然后有四个部分，每个部分包含一个数字和一个后缀。 各节的ASCII后缀为“D”、“H”、“M”和“S”，表示日、小时、分钟和秒，可使用大写或小写。 后缀必须按顺序出现。 ASCII字母“T”必须出现在小时、分钟或秒部分的第一次（如果有）之前。 四个部分中的至少一个必须存在，如果存在“T”，则“T”后面必须至少有一个部分。 每个部分的数字部分必须包含一个或多个ASCII数字。 数字可以用ASCII负号或正号作为前缀。 必须将天数、小时数和分钟数解析为。 必须解析到的秒数以及可选的分数。 小数点可以是点或逗号。 小数部分可以有0到9位数字。

toDuration(<string>)

toDuration(<integer>)

返回持续时间。

toDuration("PT10H")

返回10小时的持续时间。

toDuration("PT4S")

返回4秒的持续时间。

toDuration(4000)

返回4秒的持续时间。

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

返回整数。

toInteger("4")

返回4。

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

返回字符串。

toString(4)

返回“4”。

toString(#{ExperiencePlatform.test_date.person.birthDate}))

返回给定dateOnly字段（XDM日期字段）的字符串表示形式，例如“2023-08-18”。

toString(toDuration(1520))

返回“PT1.52S”。

本节包含结构化知识，用于支持与本主题相关的解释、检索和问答。

要全面了解相关信息，应将此信息与本页上的文档相结合。 这两个源都不是独立的；页面描述了功能，而本节提供了其他上下文来帮助消除术语、意图、适用性和约束条件的歧义。

• TL；DR：​本页记录了AJO历程表达式中的所有转换函数，说明了如何在字符串、整数、小数、布尔值、日期、日期时间和持续时间等类型之间转换值。

意图：

• 使用toDateTime将字符串或epoch整数转换为可识别时区的日期时间
• 使用toDateTimeOnly将字符串或日期时间转换为无时区的日期时间
• 使用toDateOnly从字符串或日期时间中提取仅日期值（年 — 月 — 日）
• 使用toInteger、toDecimal或toBool将值转换为整数、小数或布尔值
• 使用toString将任何值序列化为其字符串表示形式
• 使用toDuration将字符串或毫秒整数转换为持续时间

术语表：

• dateTime：包含时区偏移信息​ （产品特定） ​的日期时间值
• dateTimeOnly：没有时区信息的日期时间值​（产品特定）
• dateOnly：表示年月日的日期值，没有时间组件​（产品特定）
• 持续时间：以ISO-8601格式表示的时间段（例如，PT10H） （产品特定）
• 纪元毫秒：自1970-01-01T00:00:00Z以来以毫秒表示的Unix时间戳

护栏：

• toDateTime中的时区参数必须是字符串常量 — 不允许字段引用和动态表达式
• toDateTime和toDateTimeOnly的字符串输入必须遵循ISO-8601格式；格式错误的字符串返回空值，并且没有错误
• 带有epoch整数的toDateTime需要毫秒；将基于秒的时间戳乘以1000，然后再传递
• toBool只为确切的字符串"true"返回true；诸如"1"、"yes"或"TRUE"之类的字符串返回false

术语：

• 规范名称：转换函数 — 首字母缩写：none — 变体：类型转换函数，类型转换函数
• 同义词： “toDateTime” = “convert to datetime with timezone”； “toDateTimeOnly” = “convert to datetime without timezone”
• 请勿混淆：“toDateTime”（可识别时区）≠“toDateTimeOnly”（无时区）
• 请勿混淆：“toDateOnly”（仅限日期，无时间）≠“toDateTime”（具有时区的日期和时间）

常见问题解答：

• 问：何时应使用toDateTime而非toDateTimeOnly？ — 在时区信息很重要时使用toDateTime（例如，计划或跨区域比较）；在只有本地日期时间相关并且时区可以忽略时使用toDateTimeOnly。
• 问：为什么toBool("TRUE")返回false？ — toBool仅识别精确的小写字符串"true"；所有其他字符串值（包括"TRUE"或"yes"）返回false。
• 问：如何将以秒为单位的Unix时间戳转换为dateTime？ — 将秒值乘以1000以获得毫秒，然后将其传递给toDateTime，例如toDateTime(myField * 1000)。
• 问：能否从配置文件属性读取toDateTime中的时区？ — 否，时区ID必须是字符串常量；不支持字段引用和表达式。
• 问：toDuration接受哪种格式作为字符串？ — ISO-8601持续时间格式，例如，"PT10H"表示10小时，"P1DT2H"表示1天又2小时。