Fonctions de conversion conversion-functions

• décimal
• booléen
• chaîne
• entier

toBool(<decimal>)

toBool(<boolean>)

toBool(<string>)

toBool(<integer>)

Renvoie une valeur booléenne.

toBool("true")

toBool(1)

Renvoie true.

toBool("this is not a boolean")

Renvoie false.

toDateOnly(<dateTime>)

toDateOnly(<dateTimeOnly>)

toDateOnly(<string>)

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

Renvoie une valeur de type dateOnly.

toDateOnly("2023-08-18")

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

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

renvoient tous un objet dateOnly représentant 18/08/2023.

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

Renvoie une valeur dateOnly.

toDateTime(<string>)

toDateTime(<string>, <dateOnly>)

toDateTime(<string>, <dateTimeOnly>)

toDateTime(<integer>)

Renvoie une valeur dateTime.

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

Renvoie 2023-08-18T23:17:59.123Z.

La chaîne ISO-8601 inclut déjà des informations sur le fuseau horaire.

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

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

Vous créez ainsi une valeur dateTime en combinant un fuseau horaire avec une valeur de date seule. L’heure est définie sur minuit (00:00:00) dans le fuseau horaire spécifié.

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

Renvoie 2023-08-18T23:17:59.123Z.

Vous créez ainsi une valeur dateTime en appliquant un fuseau horaire à une valeur dateTimeOnly (qui ne contient aucune information de fuseau horaire).

toDateTime(1560762190189)

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

Convertit une date et une heure Unix en millisecondes en une valeur dateTime.

toDateTimeOnly(<dateTime>)

toDateTimeOnly(<string>)

Renvoie une date et une heure sans prendre en compte le fuseau horaire.

toDateTimeOnly ("2023-08-18")

Renvoie une valeur dateTime représentant 2023-08-18T00:00:00.000.

toDateTimeOnly(now())

toDecimal(<integer>)

toDecimal(<decimal>)

toDecimal(<string>)

toDecimal(<boolean>)

Renvoie une valeur décimale.

toDecimal("4.0")

Renvoie 4.0.

Si l’expression contient une chaîne : les formats acceptés sont basés sur le format de durée ISO-8601 PnDTnHnMn.nS pour une durée du jour considérée comme durant exactement 24 heures.

La chaîne commence par un signe facultatif, indiqué par le symbole ASCII négatif ou positif. S’il est négatif, toute la période est annulée. Vient ensuite la lettre ASCII « P », en majuscule ou en minuscule. Viennent ensuite quatre sections, chacune constituée d’un nombre et d’un suffixe. Les sections contiennent les suffixes en ASCII « D », « H », « M » et « S » pour les jours, heures, minutes et secondes, acceptés en majuscules ou en minuscules. Les suffixes doivent se succéder dans l’ordre. La lettre ASCII « T » doit apparaître avant la première occurrence, le cas échéant, d’une section d’heure, de minute ou de seconde. L’une au moins des quatre sections doit être présente, et si la lettre « T » est présente, elle doit être suivie d’au moins une section. La partie numérique de chaque section doit contenir un ou plusieurs chiffres ASCII. Le nombre peut être précédé du symbole ASCII négatif ou positif. Le nombre de jours, heures et minutes doit être converti en nombre long. Le nombre de secondes doit être converti en nombre long avec la fraction facultative. La virgule peut être un point ou une virgule. La partie fractionnaire peut comporter de zéro à 9 chiffres.

toDuration(<string>)

toDuration(<integer>)

Renvoie une durée.

toDuration("PT10H")

Renvoie une durée de 10 heures.

toDuration("PT4S")

Renvoie une durée de 4 s.

toDuration(4000)

Renvoie une durée de 4 s.

toInteger(<dateTime>)

toInteger(<decimal>)

toInteger(<integer>)

toInteger(<string>)

toInteger(<boolean>)

Renvoie un nombre entier.

toInteger("4")

Renvoie 4.

toString(<dateTimeOnly>)

toString(<dateTime>)

toString(<duration>)

toString(<boolean>)

toString(<integer>)

toString(<decimal>)

Renvoie une chaîne.

toString(4)

Renvoie « 4 ».

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

Renvoie la représentation sous forme de chaîne du champ dateOnly (champ de date XDM) donné, par exemple « 18/08/2023 ».

toString(toDuration(1520))

Renvoie « PT1.52S ».

Cette section contient des connaissances structurées destinées à soutenir l’interprétation, la récupération et la réponse aux questions liées à ce sujet.

Pour une compréhension totale, ces informations doivent être combinées avec la documentation de cette page. Aucune des sources n’est conçue pour être autonome. La page décrit la fonctionnalité, tandis que cette section fournit un contexte supplémentaire qui permet de clarifier la terminologie, l’intention, l’applicabilité et les contraintes.

• TL;DR: Cette page documente toutes les fonctions de conversion dans les expressions de parcours AJO, en expliquant comment transformer des valeurs entre des types tels que chaîne, entier, décimal, booléen, date, datetime et durée.

Intentions:

• Convertissez une chaîne ou un entier epoch en une heure prenant en compte le fuseau horaire à l’aide de toDateTime
• Convertir une chaîne ou datetime en datetime sans fuseau horaire à l’aide de toDateTimeOnly
• Extrayez une valeur de date seule (année-mois-jour) d’une chaîne ou de datetime à l’aide de toDateOnly
• Convertissez une valeur en entier, décimal ou booléen en utilisant toInteger, toDecimal ou toBool
• Sérialisez n’importe quelle valeur dans sa représentation sous forme de chaîne à l’aide de toString
• Convertir une chaîne ou un entier en millisecondes en une durée à l’aide de toDuration

Glossaire:

• dateTime : valeur datetime qui inclut des informations de décalage de fuseau horaire (spécifiques au produit)
• dateTimeOnly : valeur datetime sans informations de fuseau horaire (spécifique au produit)
• dateOnly : valeur de date représentant l’année-mois-jour sans composant temporel (spécifique au produit)
• durée : période exprimée au format ISO-8601 (par exemple, PT10H) (spécifique au produit)
• epoch milliseconds : horodatage Unix exprimé en millisecondes depuis 1970-01-01T00:00:00Z

Mécanismes de sécurisation :

• L’argument de fuseau horaire dans toDateTime doit être une constante de chaîne — les références aux champs et les expressions dynamiques ne sont pas autorisées
• Les entrées de chaîne dans toDateTime et toDateTimeOnly doivent respecter le format ISO-8601 ; les chaînes incorrectes renvoient la valeur null sans erreur
• toDateTime avec un entier epoch attend des millisecondes ; multipliez les horodatages basés sur les secondes par 1 000 avant de passer
• toBool renvoie true uniquement pour le "true" de chaîne exact ; les chaînes telles que "1", "yes" ou "TRUE" renvoient false

Terminologie:

• Nom canonique : Fonctions de conversion — Acronyme : none — variantes : fonctions de conversion de type, fonctions de conversion de type
• Synonymes : « toDateTime » = « convert to datetime with timezone »; « toDateTimeOnly » = « convert to datetime without timezone »
• Ne pas confondre : « toDateTime » (compatible avec les fuseaux horaires) ≠ « toDateTimeOnly » (pas de fuseau horaire)
• Ne pas confondre : « toDateOnly » (date uniquement, pas d’heure) ≠ « toDateTime » (date et heure avec fuseau horaire)

FAQ:

• Q : Quand dois-je utiliser toDateTime plutôt que toDateTimeOnly ? — Utilisez des toDateTime lorsque les informations sur le fuseau horaire sont importantes (par exemple, planification ou comparaisons interrégions) ; utilisez des toDateTimeOnly lorsque seule la date-heure locale est pertinente et que le fuseau horaire peut être ignoré.
• Q : Pourquoi toBool("TRUE") renvoie-t-il false ? — toBool ne reconnaît que la "true" exacte de la chaîne en minuscules ; toutes les autres valeurs de chaîne, y compris "TRUE" ou "yes", renvoient la valeur false.
• Q : Comment convertir un horodatage Unix en secondes en dateTime ? — Multipliez la valeur secondes par 1000 pour obtenir les millisecondes, puis transmettez-la à toDateTime, par exemple toDateTime(myField * 1000).
• Q : Le fuseau horaire dans toDateTime peut-il être lu à partir d’un attribut de profil ? — Non, l’ID de fuseau horaire doit être une constante de chaîne ; les références aux champs et les expressions ne sont pas prises en charge.
• Q : Quel format accepte-toDuration comme chaîne ? — format de durée ISO-8601, par exemple "PT10H" pour 10 heures ou "P1DT2H" pour 1 jour et 2 heures.