DateTimeValue

Syntaxe

Paramètres

Description

Cette fonction permet de convertir une chaîne de texte en une valeur de date et d'heure.

Remarques

• La fonction DateTimeValue est essentielle lorsqu'on souhaite convertir une chaîne de texte représentant une date et une heure en une véritable valeur exploitable dans Power Fx. Cela permet par exemple de traiter des données saisies par l'utilisateur ou issues de sources externes sous forme de texte. Elle facilite ainsi la normalisation des formats de date dans les applications.
• Le paramètre String est le cour de cette fonction, car il contient le texte que l'on souhaite transformer. Ce texte peut être dans différents formats de date, tels que "24/05/2025 14:30" ou "May 24, 2025 2:30 PM", selon la culture ou la source. La fonction tente automatiquement de détecter et d'interpréter correctement ce format.
• Le second paramètre optionnel Language est très utile pour interpréter correctement les chaînes de date dans des contextes multilingues. Par exemple, une date comme "01/12/2025" sera interprétée différemment en anglais (mois/jour) ou en français (jour/mois). La spécification explicite de la langue réduit les erreurs de conversion.
• Le paramètre Untyped permet de convertir des valeurs n'étant pas explicitement typées comme du texte mais pouvant tout de même représenter des dates. Ce cas est fréquent lorsque l'on traite des données dynamiques ou issues de connecteurs externes. Power Fx offre ici une flexibilité précieuse pour adapter le traitement selon la nature de l'entrée.
• DateTimeValue est idéale pour transformer des champs de formulaire, des entrées utilisateurs ou des données JSON où les dates sont souvent représentées comme des chaînes. Une fois convertie, la valeur peut ensuite être utilisée avec toutes les fonctions temporelles telles que DateAdd, DateDiff, ou Text. Cela améliore la cohérence des traitements temporels dans l'application.
• Cette fonction peut également être utilisée pour valider que le format d'une chaîne est correct avant d'effectuer des opérations plus complexes. Si le format est invalide ou ambigü, la conversion échouera, ce qui permet de détecter et corriger les erreurs en amont. Elle joue donc un rôle dans la robustesse des traitements liés au temps.
• L'utilisation de la langue peut inclure des identifiants tels que "fr-FR" ou "en-US", ce qui permet de définir précisément la culture utilisée pour l'interprétation. Cela permet de déployer une même application dans plusieurs régions linguistiques sans réécrire la logique de conversion. Un aspect fondamental pour les applications internationales ou multilingues.
• Grâce à DateTimeValue, on peut stocker ou comparer des dates dans des formats standards, indépendamment de leur présentation initiale. Cela est particulièrement utile pour filtrer des données, effectuer des tris chronologiques ou afficher des informations temporelles dans des composants visuels. Elle simplifie grandement la gestion du temps dans Power Fx tout en offrant une grande flexibilité de traitement.