TimeValue |
Valeur de l'heure |
| Power Fx |
Syntaxe
|
TimeValue( String [, Language ])
|
|
TimeValue( Untyped )
|
Paramètres
| Nom |
Description |
| String |
Ce paramètre contient la chaîne de texte représentant une heure à convertir (ex. : "14:30" ou "2:30 PM"). |
| Language |
Ce paramètre permet d'indiquer la langue utilisée pour interpréter la chaîne si elle contient des éléments localisés. |
| Untyped |
Ce paramètre permet de transmettre une valeur sans type explicite, à évaluer comme une heure si possible. |
Description
Cette fonction permet de convertir une chaîne de texte en une valeur de temps.
Remarques
- La fonction TimeValue est très utile pour extraire des heures depuis des chaînes de texte : Elle permet de transformer des représentations textuelles
d'horaires, comme "15:45" ou "9:00 AM", en véritables valeurs de type Time. Cela facilite les calculs temporels dans une application Power Apps.
- Elle permet d'interpréter correctement les formats d'heure localisés : Grâce au paramètre Language, on peut indiquer la culture attendue pour
l'analyse de la chaîne. Cela évite les erreurs de conversion quand l'application est utilisée dans des contextes multilingues, par exemple en anglais ou en français.
- TimeValue accepte des formats variés selon la langue définie : Avec le paramètre Language, on peut adapter l'analyse à des formats comme
"14 h 30" (français) ou "2:30 PM" (anglais). Cette flexibilité permet une meilleure compatibilité avec les préférences utilisateur.
- Le paramètre Untyped rend la fonction plus dynamique : En autorisant des valeurs non typées, comme des entrées utilisateur, la fonction peut essayer
d'interpréter automatiquement une chaîne comme une heure, sans exiger une structure formelle ou un format rigide.
- Elle facilite le traitement d'horaires saisis par l'utilisateur : Lorsqu'un utilisateur entre un horaire dans une zone de texte, TimeValue permet
de convertir facilement cette entrée pour l'utiliser ensuite dans des comparaisons ou des calculs de durée.
- Elle évite d'avoir à manipuler manuellement des heures via Time() : Plutôt que de devoir extraire séparément les heures, minutes et secondes pour
construire une valeur de temps, TimeValue permet d'obtenir ce résultat à partir d'une simple chaîne bien formatée.
- Elle peut générer des erreurs si le format n'est pas reconnu : Il est important de s'assurer que la chaîne transmise correspond à un format valide.
Sinon, Power Fx retournera une erreur, en particulier si aucun Language n'est précisé dans un environnement multilingue.
- TimeValue est particulièrement utile dans les applications à logique horaire : Dans les cas d'usage liés aux plages horaires (réservations, horaires
d'ouverture, emplois du temps), elle permet de convertir des données texte en heures exploitables pour des règles métier, des alertes ou des filtres.
Dernière mise à jour : Jeudi, le 1 Mai 2025