转换函数 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”。

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

• TL;DR: This page documents all conversion functions in AJO journey expressions, explaining how to transform values between types such as string, integer, decimal, boolean, date, datetime, and duration.

Intents:

• Convert a string or epoch integer to a timezone-aware datetime using toDateTime
• Convert a string or datetime to a timezone-less datetime using toDateTimeOnly
• Extract a date-only value (year-month-day) from a string or datetime using toDateOnly
• Cast a value to an integer, decimal, or boolean using toInteger, toDecimal, or toBool
• Serialize any value to its string representation using toString
• Convert a string or millisecond integer to a duration using toDuration

Glossary:

• dateTime: A datetime value that includes timezone offset information (product-specific)
• dateTimeOnly: A datetime value with no timezone information (product-specific)
• dateOnly: A date value representing year-month-day with no time component (product-specific)
• duration: A time period expressed in ISO-8601 format (e.g., PT10H) (product-specific)
• epoch milliseconds: Unix timestamp expressed in milliseconds since 1970-01-01T00:00:00Z

Guardrails:

• The timezone argument in toDateTime must be a string constant — field references and dynamic expressions are not allowed
• String inputs to toDateTime and toDateTimeOnly must follow ISO-8601 format; malformed strings return null without an error
• toDateTime with an epoch integer expects milliseconds; multiply seconds-based timestamps by 1000 before passing
• toBool returns true only for the exact string "true"; strings like "1", "yes", or "TRUE" return false

Terminology:

• Canonical name: Conversion functions — Acronym: none — variants: type casting functions, type conversion functions
• Synonyms: “toDateTime” = “convert to datetime with timezone”; “toDateTimeOnly” = “convert to datetime without timezone”
• Do not confuse: “toDateTime” (timezone-aware) ≠ “toDateTimeOnly” (no timezone)
• Do not confuse: “toDateOnly” (date only, no time) ≠ “toDateTime” (date and time with timezone)

FAQ:

• Q: When should I use toDateTime versus toDateTimeOnly? — Use toDateTime when timezone information matters (e.g., scheduling or cross-region comparisons); use toDateTimeOnly when only the local date-time is relevant and timezone can be ignored.
• Q: Why does toBool("TRUE") return false? — toBool only recognizes the exact lowercase string "true"; all other string values including "TRUE" or "yes" return false.
• Q: How do I convert a Unix timestamp in seconds to a dateTime? — Multiply the seconds value by 1000 to get milliseconds, then pass it to toDateTime, e.g., toDateTime(myField * 1000).
• Q: Can the timezone in toDateTime be read from a profile attribute? — No, the timezone ID must be a string constant; field references and expressions are not supported.
• Q: What format does toDuration accept as a string? — ISO-8601 duration format, e.g., "PT10H" for 10 hours or "P1DT2H" for 1 day and 2 hours.