Funciones de conversión conversion-functions

• decimal
• Booleano
• cadena
• entero

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Devuelve un valor booleano.

toBool("true")

toBool(1)

Devuelve verdadero.

toBool("this is not a boolean")

Devuelve falso.

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Devuelve un valor de tipo dateOnly.

toDateOnly("2023-08-18")

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

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

todos devuelven un objeto dateOnly que representa el 18-08-2023.

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

Devuelve dateOnly.

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Devolver dateTime.

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

Devuelve 2023-08-18T23:17:59.123Z

La cadena ISO-8601 ya incluye información de zona horaria.

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

Devuelve 2023-08-18T00:00:00.000+02:00

Esto crea un dateTime combinando una zona horaria con un valor de solo fecha. La hora se establece en medianoche (00:00:00) en la zona horaria especificada.

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

Devuelve 2023-08-18T23:17:59.123Z

Esto crea un dateTime al aplicar una zona horaria a un valor dateTimeOnly (que no tiene información de zona horaria).

toDateTime(1560762190189)

Devuelve 2019-06-17T09:03:10.189Z

Convierte una marca de tiempo Unix en milisegundos en un valor dateTime.

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Devuelve una fecha y hora sin tener en cuenta la zona horaria.

toDateTimeOnly ("2023-08-18")

devuelve un valor dateTime que representa el valor 2023-08-18T00:00:00.000

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Devuelve un decimal.

toDecimal("4.0")

Devuelve 4.0.

Expresión de cadena If: los formatos aceptados se basan en el formato de duración ISO-8601 PnDTnHnMn.nS con días considerados exactamente 24 horas.

La cadena comienza con un signo opcional, indicado por el símbolo ASCII negativo o positivo. Si es negativo, se anula todo el periodo. La letra ASCII “P” es la siguiente en mayúsculas o minúsculas. A continuación, hay cuatro secciones, cada una de las cuales consta de un número y un sufijo. Las secciones tienen sufijos en ASCII de “D”, “H”, “M” y “S” para días, horas, minutos y segundos, aceptados en mayúsculas o minúsculas. Los sufijos deben aparecer en orden. La letra ASCII “T” debe aparecer antes de la primera aparición, si la hay, de una sección de hora, minuto o segunda. Al menos una de las cuatro secciones debe estar presente, y si “T” está presente debe haber al menos una sección después de la “T”. La parte numérica de cada sección debe constar de uno o más dígitos ASCII. El número puede ir precedido del símbolo ASCII negativo o positivo. El número de días, horas y minutos que se deben analizar. El número de segundos debe analizarse en junto con una fracción opcional. El punto decimal puede ser un punto o una coma. La parte fraccionada puede tener de cero a 9 dígitos.

toDuration(<string>)

toDuration(<integer>)

Devuelve una duración.

toDuration("PT10H")

Devuelve una duración de 10 horas.

toDuration("PT4S")

Devuelve la duración de 4 segundos.

toDuration(4000)

Devuelve la duración de 4 segundos.

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Devuelve un entero.

toInteger("4")

Devuelve 4.

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Devolver una cadena.

toString(4)

Devuelve “4”.

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

Devuelve la representación de cadena del campo dateOnly dado (campo de fecha XDM), por ejemplo “2023-08-18”.

toString(toDuration(1520))

Devuelve “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.