Funciones de conversión conversion-functions

Las funciones de conversión permiten transformar datos de un tipo a otro dentro de las expresiones de recorrido. Estas funciones son esenciales para garantizar la compatibilidad de los datos y la administración adecuada de tipos al trabajar con diferentes fuentes de datos y operaciones.

Utilice las funciones de conversión cuando necesite:

  • Convertir valores de cadena a tipos numéricos, booleanos o de fecha (toInteger, toDecimal, toBool)
  • Transformar fechas y horas entre diferentes formatos y representaciones (toDateTime, toDateTimeOnly, toDateOnly)
  • Convierta valores numéricos entre tipos enteros y decimales (toInteger, toDecimal)
  • Convertir valores al formato de cadena (toString) o duración (toDuration)
  • Garantizar la compatibilidad de tipos para comparaciones y operaciones
  • Procesar datos de fuentes externas que pueden tener diferentes formatos de tipo

Cada función de conversión gestiona automáticamente las reglas específicas del tipo y los casos extremos, lo que hace que la transformación de datos sea más fiable y predecible en las expresiones de recorrido.

toBool toBool

Convierte un valor de argumento en un valor booleano, según su tipo.

  • Desde cadena: intente convertir el valor de cadena como booleano, de "true" si el valor de cadena es "true" y de "false" en caso contrario
  • Desde numérico: true si el valor numérico no es igual a 0, false en caso contrario
Sintaxis
toBool(<parameter>)
Parámetros
  • decimal
  • Booleano
  • cadena
  • entero
Firmas y tipos devueltos

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Devuelve un valor booleano.

Ejemplos

toBool("true")

toBool(1)

Devuelve verdadero.

toBool("this is not a boolean")

Devuelve falso.

toDateOnly toDateOnly

Convierte un argumento en un valor de tipo dateOnly. Para obtener más información sobre los tipos de datos, consulte esta sección.

Sintaxis
toDateOnly(<parameters>)
Parámetros
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parámetro Tipo
Representación de cadena de una fecha como "AAAA-MM-DD" (formato XDM). También admite el formato ISO-8601: solo se tiene en cuenta la parte full-date (consulte RFC 3339, sección 5.6 cadena
fecha y hora dateTime
fecha y hora sin zona horaria dateTimeOnly
valor entero de una época en milisegundos entero
Firmas y tipos devueltos

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Devuelve un valor de tipo dateOnly.

Ejemplos

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 toDateTime

Convierte los parámetros en un valor de fecha y hora, según sus tipos.

Sintaxis
toDateTime(<parameters>)
Parámetros
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parámetro Tipo
fecha y hora en formato ISO-8601 cadena
id de zona horaria cadena
fecha y hora sin zona horaria dateTimeOnly
valor entero de una época en milisegundos entero
Firmas y tipos devueltos

toDateTime(<string>)

toDateTime(<stringified time zone id>, <dateTimeOnly>)

toDateTime(<integer>)

Devolver dateTime.

Ejemplos

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

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

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

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

toDateTime(1560762190189)

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

NOTE
El ID de zona horaria debe ser una constante de cadena. No puede ser una referencia de campo ni una expresión. Para obtener más información sobre los tipos de datos, consulte esta página.

toDateTimeOnly toDateTimeOnly

Convierte un valor de argumento en un valor de solo fecha y hora.

Sintaxis
toDateTimeOnly(<parameters>)
Parámetros
table 0-row-2 1-row-2 2-row-2
Parámetro Tipo
fecha y hora en formato ISO-8601 o "AAAA-MM-DD" (formato de fecha XDM) cadena
fecha y hora dateTime
Firmas y tipos devueltos

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

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

Ejemplos

toDateTimeOnly ("2023-08-18")

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

toDateTimeOnly(now())

toDecimal toDecimal

Convierte un valor de argumento en un valor decimal, según su tipo.

Sintaxis
toDecimal(<parameter>)
Parámetros
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parámetro Descripción
cadena convierte el valor de cadena como decimal
dateTime convierte la fecha como el número de milisegundos (epoch milisegundos)
Booleano convierte el valor booleano como 1 si es verdadero, 0 si es falso
entero convierte a decimal (ejemplo).: 1 se convierte en 1,0)
Firmas y tipos devueltos

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Devuelve un decimal.

Ejemplos

toDecimal("4.0")

Devuelve 4.0.

toDuration toDuration

Convierte un valor de argumento en una duración. Para obtener más información sobre los tipos de datos, consulte esta página.

Sintaxis
toDuration(<parameter>)
Parámetros
table 0-row-2 1-row-2 2-row-2
Parámetro Descripción
cadena formatos basados en el formato de duración ISO-8601 PnDTnHnMn.nS con días considerados exactamente 24 horas
entero número de milisegundos

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.

Firmas y tipo devuelto

toDuration(<string>)

toDuration(<integer>)

Devuelve una duración.

Ejemplos

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 toInteger

Convierte un valor de argumento en un entero.

Sintaxis
toInteger(<parameter>)
Parámetros
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
Parámetro Descripción
cadena convierte el valor de cadena como un entero
dateTime convierte la fecha como el número de milisegundos (epoch milisegundos)
decimal convierte en entero eliminando la parte decimal (ejemplo: 1,5 se convierte en 1)
Booleano convierte el valor booleano como 1 si es verdadero, 0 si es falso
Firmas y tipo devuelto

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Devuelve un entero.

Ejemplos

toInteger("4")

Devuelve 4.

toString toString

Convierte un valor de argumento en un valor de cadena, según su tipo. Para obtener más información sobre los tipos de datos, consulte esta página.

Sintaxis
toString(<parameter>)
Parámetros
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
Parámetro Descripción
dateTime convierte la fecha en formato UTC
dateTimeOnly convierte la fecha en formato UTC
duration convertir en el número correspondiente de milisegundos como cadena
entero convierte en una representación de cadena del valor (1 se convierte en "1")
decimal convierte en una representación de cadena del valor (1,5 se convierte en "1,5")
Booleano convertir el valor booleano como "true" si es verdadero, como "false" si es falso
Firmas y tipo devuelto

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Devolver una cadena.

Ejemplos

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

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76