Syntaxe
|
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
|
|
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
|
|
Text ( Untyped )
|
Paramètres
| Nom |
Description |
| NumberOrDateTime |
Ce paramètre représente une valeur numérique ou une valeur de type date/heure à convertir en texte. |
| DateTimeFormatEnum |
Ce paramètre représente un format de date/heure prédéfini (comme DateTimeFormat.ShortDate) qui détermine la manière dont la date ou l'heure sera affichée. |
| CustomFormat |
Ce paramètre représente une chaîne de format personnalisée (comme "yyyy-mm-dd" ou "#,##0.00") utilisée pour formater la valeur. |
| ResultLanguageTag |
Ce paramètre facultatif représente la langue et la culture (par exemple "fr-FR" ou "en-US") utilisées pour formater le résultat. |
| Untyped |
Ce paramètre permet de formater des valeurs non typées (comme des entrées dynamiques), en les convertissant automatiquement selon leur nature (nombre, date...). |
Description
Cette fonction convertit une valeur en texte et formate un nombre ou une valeur de date/heure en une chaîne de texte.
Remarques
- La fonction Text est essentielle pour le formatage d'affichage : La fonction Text permet de transformer des données brutes comme des nombres
ou des dates en chaînes lisibles. Cela est particulièrement utile pour adapter l'affichage des informations dans une interface utilisateur, comme afficher une date au
format "dd/mm/yyyy" ou un prix avec une devise.
- Elle offre une grande flexibilité grâce au format personnalisé : En utilisant le paramètre CustomFormat, on peut créer des formats précis adaptés aux
besoins de l'application. Par exemple, pour les données monétaires, le format "#,##0.00 €" permet d'afficher les valeurs avec deux décimales et un symbole monétaire
à droite.
- Le format dépend fortement de la culture choisie : Le paramètre ResultLanguageTag joue un rôle important dans l'affichage. Un même format personnalisé
peut produire des résultats différents selon qu'on utilise "en-US" ou "fr-FR", notamment pour les séparateurs de milliers ou le nom des mois.
- Compatible avec des données dynamiques non typées : La fonction accepte aussi des entrées non typées (Untyped), ce qui permet de convertir des valeurs
issues de sources incertaines (exemple JSON ou saisie utilisateur) en texte, tout en appliquant automatiquement un format
en fonction du type détecté.
- Indispensable pour la concaténation de texte avec des données : La fonction Text permet d'intégrer facilement des données numériques ou temporelles
dans des chaînes affichées. Par exemple : "Montant total : " & Text(Sum(Prix), "#,##0.00 ?") permet d'unifier contenu statique et valeur calculée.
- Peut être utilisée pour la localisation d'applications : Grâce au ResultLanguageTag, on peut adapter dynamiquement l'affichage des valeurs selon la
langue de l'utilisateur, sans changer la logique métier. Cela facilite grandement le développement d'applications multilingues dans Power Apps.
- Elle simplifie l'export ou la génération de rapports : Lorsqu'on souhaite exporter des données sous forme de texte (par exemple, pour une impression
PDF ou un fichier Excel), la fonction Text permet de formater toutes les valeurs exactement comme requis pour une lecture humaine.
- À utiliser avec prudence pour les calculs ultérieurs : Une fois qu'une valeur est convertie en texte, elle ne peut plus être utilisée directement dans
des calculs numériques ou des opérations de date. Il faut donc bien distinguer les cas d'usage : affichage visuel versus traitement mathématique.
Dernière mise à jour : Jeudi, le 1 Mai 2025
