轉換函式 conversion-functions

• 小數
• 布林值
• 字串
• 整數

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

傳回布林值。

toBool("true")

toBool(1)

傳回true。

toBool("this is not a boolean")

傳回false。

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

這會將時區與僅限日期的值結合，以建立dateTime。 時間設定為指定時區的午夜(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的dateTime

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")

傳回4s的持續時間。

toDuration(4000)

傳回4s的持續時間。

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.