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
toBool(<parameter>)- 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 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.
toDateOnly(<parameters>)| 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 |
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 toDateTime
Convierte los parámetros en un valor de fecha y hora, según sus tipos.
toDateTime(<parameters>)| 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 |
toDateTime(<string>)
toDateTime(<stringified time zone id>, <dateTimeOnly>)
toDateTime(<integer>)
Devolver dateTime.
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
toDateTimeOnly toDateTimeOnly
Convierte un valor de argumento en un valor de solo fecha y hora.
toDateTimeOnly(<parameters>)| 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 |
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 toDecimal
Convierte un valor de argumento en un valor decimal, según su tipo.
toDecimal(<parameter>)| 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) |
toDecimal(<integer>)
toDecimal(<decimal>)
toDecimal(<string>)
toDecimal(<boolean>)
Devuelve un decimal.
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.
toDuration(<parameter>)| 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.
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 toInteger
Convierte un valor de argumento en un entero.
toInteger(<parameter>)| 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 |
toInteger(<dateTime>)
toInteger(<decimal>)
toInteger(<integer>)
toInteger(<string>)
toInteger(<boolean>)
Devuelve un entero.
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.
toString(<parameter>)| 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 |
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".