Fonction Text
S’applique à :
Applications canevas Applications canevas Colonnes de formule Dataverse Applications pilotées par modèle CLI Power Platform
Convertit n’importe quelle valeur, et met en forme un nombre ou une valeur de date/heure en une chaîne de texte.
Description
La fonction Text met en forme un nombre ou une valeur de date/heure en fonction de l’un de ces types d’arguments :
- Un format de date/heure prédéfini que vous spécifiez à l’aide de l’énumération DateTimeFormat. Pour les dates et heures, cette approche est recommandée, car elle s’adapte automatiquement à la langue et à la région de chaque utilisateur.
- Un format personnalisé, qui comprend une chaîne d’espaces réservés qui définissent, par exemple, si les nombres affichent un séparateur décimal et les dates affichent le nom complet du mois, le mois en abréviation ou le mois en nombre. Power Apps prend en charge un sous-ensemble d’espaces réservés compatible avec Microsoft Excel. Dans cette chaîne, l’espace réservé de langue spécifie la langue dans laquelle interpréter les autres espaces réservés. Si le format personnalisé comprend un point, par exemple, l’espace réservé au format de langue spécifie si le point est un séparateur décimal (ja-JP) ou un séparateur de milliers (es-ES).
Pour plus d’informations, voir Utilisation des dates et heures.
La fonction Text peut également convertir n’importe quel type de données en une représentation textuelle en utilisant un format par défaut. Utilisez ceci pour passer des valeurs non textuelles à des fonctions textuelles telles que Len, Right et IsMatch.
Formats de date et d’heure prédéfinis
Pour ces exemples, la date et l’heure utilisées sont le mardi 7 avril 2020 8:26:59.180 PM, dans le fuseau horaire UTC-7 heures.
| DateTimeFormat enum | Description | Exemples (utilisation en-US) |
|---|---|---|
| LongDate | Année à quatre chiffres, nom du mois, jour du mois et jour de la semaine. Les noms du mois et du jour de la semaine ne sont pas abrégés. | « mardi 7 avril 2020 » |
| LongDateTime | Année à quatre chiffres, nom du mois, jour du mois et jour de la semaine, ainsi que l’heure (au format 12 heures), les minutes, les secondes et la désignation AM/PM. Les noms du mois et du jour de la semaine ne sont pas abrégés. | « mardi 7 avril 2020 8:26:59 PM » |
| LongDateTime24 | Année à quatre chiffres, mois, jour du mois et jour de la semaine, ainsi que l’heure (au format 24 heures), les minutes et les secondes. Les noms du mois et du jour de la semaine ne sont pas abrégés. | « mardi 7 avril 2020 20:26:59 » |
| LongTime | Heure (au format 12 heures), minutes, secondes et désignation AM/PM. | « 8:26:59 PM » |
| LongTime24 | Heure (au format 24 heures), minutes, secondes. | « 20:26:59 » |
| ShortDate | Année à quatre chiffres, mois numérique et jour du mois. | « 4/7/2020 » |
| ShortDateTime | Année à quatre chiffres, mois numérique, jour du mois, ainsi que l’heure (au format 12 heures), les minutes et la désignation AM/PM. | « 4/7/2020 8:26 PM » |
| ShortDateTime24 | Année à quatre chiffres, mois numérique, jour du mois, ainsi que l’heure (au format 24 heures) et les minutes. | « 4/7/2020 20:26 » |
| ShortTime | Heure (au format 12 heures), minutes et désignation AM/PM. | « 8:26 PM » |
| ShortTime24 | Heure (au format 24 heures) et minutes. | « 20:26 » |
| UTC | La valeur de date/heure est convertie au format UTC selon le fuseau horaire de l’utilisateur actuel et mise en forme selon la norme ISO 8601. | « 2020-04-08T03:26:59.180Z » |
Espaces réservés numériques
| Espace réservé | Description |
|---|---|
| 0 (zéro) | Affiche des zéros non significatifs si un nombre contient moins de chiffres que de zéros dans le format. Par exemple, utilisez le format #.00 si vous souhaitez afficher 8.9 comme suit : 8.90. |
| # | Suit les mêmes règles que 0 (zéro). Toutefois, la fonction Text ne renvoie pas de zéros supplémentaires lorsque le nombre contient moins de chiffres de chaque côté du séparateur décimal que le nombre de symboles # dans le format. Par exemple, 8.9 s’affiche si le format personnalisé est #.## et le nombre à mettre en forme est 8.9. |
| . (period) | Affiche la décimale dans un nombre. Dépend de la langue du format personnalisé. Pour plus d’informations, voir Applications à l’échelle mondiale. |
| , (comma) | Affiche le séparateur de regroupement dans un nombre, souvent utilisé pour les milliers. La fonction Text sépare les groupes par des virgules si le format contient une virgule entre des signes dièse (#) ou des zéros. Dépend de la langue du format personnalisé. Pour plus d’informations, voir Applications à l’échelle mondiale. |
Si un nombre comporte davantage de chiffres à droite de la décimale qu’il y a d’espaces réservés dans le format, il est arrondi au nombre de décimales correspondant au nombre d’espaces réservés. S’il existe plus de chiffres à gauche de la décimale qu’il y a d’espaces réservés, les chiffres supplémentaires sont affichés. Si le format contient uniquement des signes dièse (#) à gauche de la décimale, les numéros inférieurs à 1 commencent par une décimale (par exemple, .47).
Espaces réservés de date et heure
| Espace réservé | Description |
|---|---|
| m | Affiche le mois sous la forme d’un nombre sans zéro non significatif. |
| mm | Affiche le mois sous la forme d’un nombre avec un zéro non significatif, le cas échéant. |
| mmm | Affiche le mois sous forme abrégée (Jan à Dec). |
| mmmm | Affiche le mois sous forme non abrégée (Janvier à Décembre). |
| d | Affiche le jour sous la forme d’un nombre sans zéro non significatif. |
| dd | Affiche le jour sous la forme d’un nombre avec un zéro non significatif, le cas échéant. |
| ddd | Affiche le jour sous forme abrégée (Dim à Sam). |
| dddd | Affiche le jour en entier (Dimanche à Samedi). |
| yy | Affiche l’année sous la forme d’un nombre à deux chiffres. |
| yyyy | Affiche l’année sous la forme d’un nombre à quatre chiffres. |
| h | Affiche l’heure sous la forme d’un nombre sans zéro non significatif. |
| hh | Affiche l’heure sous la forme d’un nombre avec un zéro non significatif, le cas échéant. Si le format contient AM ou PM, l’heure est présentée au format 12 heures. Sinon, l’heure est présentée au format 24 heures. |
| m | Affiche la minute sous la forme d’un nombre sans zéro non significatif. Cet espace réservé doit apparaître immédiatement après le code h ou hh ou immédiatement avant le code ss ; sinon, la fonction Text renvoie le mois au lieu de minutes. |
| mm | Affiche la minute sous la forme d’un nombre avec un zéro non significatif, le cas échéant. Cet espace réservé m ou mm doit apparaître immédiatement après l’espace réservéh ou hh ou immédiatement avant l’espace réservé ss. Sinon, la fonction Text renvoie le mois au lieu de minutes. |
| s | Affiche la seconde sous la forme d’un nombre sans zéro non significatif. |
| ss | Affiche la seconde sous la forme d’un nombre avec un zéro non significatif, le cas échéant. |
| f | Affiche les fractions de secondes. |
| AM/PM, a/p | Affiche l’heure au format 12 heures. La fonction Text renvoie « AM » ou « a » pour les heures de minuit à midi et « PM » ou « p » pour les heures de midi à minuit |
Espaces réservés pour les littéraux
Vous pouvez inclure les caractères suivants dans votre chaîne de format. Ceux-ci s’affichent dans le résultat de la fonction Text en l’état. Les caractères supplémentaires sont réservés à de futurs espaces réservés. Ne les utilisez pas.
| Caractère | Description |
|---|---|
| Symbole de devise | Dollar, Centimes, Euro, etc. |
| + | Signe Plus |
| ( | Parenthèse gauche |
| : | Deux-points |
| ^ | Accent circonflexe |
| ’ | Apostrophe |
| { | Accolade gauche |
| < | Signe Inférieur à |
| = | Signe Égal à |
| - | Signe Moins |
| / | Barre oblique |
| ) | Parenthèse droite |
| & | Esperluette |
| ~ | Tilde |
| } | Accolade droite |
| > | Signe Supérieur à |
| Espace |
Applications à l’échelle mondiale
La fonction Text reconnaît toutes les langues. Pour un grand nombre de langues, elle sait comment écrire correctement les dates, heures, devises et nombres. Pour faire son travail, elle a besoin de deux informations :
- La langue du format personnalisé : pour les auteurs, comment doit être interprété un format personnalisé ? Les caractères de séparation ( . et ,) ont des significations différentes dans différentes langues. Si vous spécifiez un format personnalisé, vous pouvez inclure un espace réservé de langue ou prendre la valeur par défaut, qui reflète la langue dans laquelle votre appareil est défini. Encore plus simple, vous pouvez utiliser l’un des formats de date/heure prédéfinis, qui sont indépendants de la langue.
- La langue du résultat : pour les utilisateurs, quelle langue doit être utilisée dans le résultat de la fonction ? Les noms des mois et des jours de la semaine doivent être dans la langue appropriée pour l’utilisateur de l’application, que vous pouvez spécifier en ajoutant un troisième argument facultatif à la fonction Text.
Pour les deux, vous spécifiez la langue à l’aide d’une balise de langue. Pour afficher la liste des langues prises en charge, tapez Text( 1234, "", ) dans la barre de formule ou l’onglet Avancé de la fenêtre de droite et faites défiler la liste des paramètres régionaux suggérés pour le troisième argument.
Espace réservé pour la langue
Pour spécifier la langue du format personnalisé, utilisez :
| Espace réservé | Description |
|---|---|
| [$-LanguageTag] | LanguageTag est une balise de langue, comme renvoyée par la fonction Language. Celle-ci peut spécifier simplement la langue (comme [$-en] pour l’anglais) ou elle peut également préciser la région (telle que [$-en-GB] pour le Royaume-Uni). |
L’espace réservé de langue peut apparaître n’importe où dans le format personnalisé, mais une seule fois.
Si vous spécifiez un format personnalisé sans espace réservé de langue et si le format est ambigu d’un point de vue global, la balise de langue de votre langue actuelle est insérée automatiquement.
L’utilisation de [$-en-US] est supposée si cet espace réservé n’est pas présent lorsque votre application est exécutée.
Note
Dans une version ultérieure, il se peut que la syntaxe de cet espace réservé soit modifiée pour éviter toute confusion avec un espace réservé similaire, mais différent, pris en charge par Excel.
Balise de langue de résultat
Le résultat de la fonction Text inclut les chaînes traduites pour les mois, les jours de semaine et les désignations AM/PM sont affichées, ainsi que le groupe approprié et les séparateurs décimaux.
Par défaut, la fonction Text utilise la langue de l’utilisateur exécutant l’application. La fonction Language renvoie la balise de langue pour l’utilisateur actuel. Vous pouvez remplacer cette valeur par défaut en fournissant une balise de langue pour le troisième argument de la fonction Text.
Syntaxe
Text( NumberOrDateTime, DateTimeFormatEnum [, ResultLanguageTag ] )
- NumberOrDateTime : obligatoire. Nombre ou valeur de date/heure à mettre en forme.
- DateTimeFormat : obligatoire. Membre de l’énumération DateTimeFormat.
- ResultLanguageTag : facultatif. Balise de langue à utiliser pour le texte de résultat. Par défaut, la langue de l’utilisateur actuel est utilisée.
Text( NumberOrDateTime, CustomFormat [, ResultLanguageTag ] )
- Number : obligatoire. Nombre ou valeur de date/heure à mettre en forme.
- CustomFormat : obligatoire. Un ou plusieurs espaces réservés entourés de guillemets doubles.
- ResultLanguageTag : facultatif. Balise de langue à utiliser pour le texte de résultat. Par défaut, la langue de l’utilisateur actuel est utilisée.
Text( AnyValue )
- AnyValue : obligatoire. Valeur à convertir en représentation textuelle. Un format par défaut est utilisé.
Text ( Sans type )
- Sans type : obligatoire. Objet sans type qui représente une chaîne. Les valeurs acceptables dépendent du fournisseur sans type. Pour JSON, si l’objet sans type est un nombre ou une valeur booléenne, il est converti en texte.
Examples
Sauf mention contraire, l’utilisateur qui exécute ces formules se trouve aux États-Unis et a sélectionné l’anglais comme langue. La fonction Language renvoie la valeur « en-US ».
Nombre
| Formule | Description | Résultat |
|---|---|---|
| Text( 1234.59, "####.#" ) | Met en forme le nombre avec une décimale. | « 1234,6 » |
| Text( 8.9, "#.000" ) | Remplit la partie décimale du nombre avec des zéros, si nécessaire. | « 8,900 » |
| Text( 0.631, "0.#" ) | Remplit la partie entière du nombre avec des zéros non significatifs, si nécessaire. | « 0,6 » |
| Text( 12, "#.0#" ) Text( 1234.568, "#.0#" ) |
Remplit la partie décimale du nombre avec des zéros pour une décimale et inclut une deuxième décimale, si celle-ci est fournie. | « 12,0 » « 1234,57 » |
| Text( 12000, "$ #,###" ) Text( 1200000, "$ #,###" ) |
Place un séparateur de milliers tous les trois chiffres et inclut un symbole monétaire. | "$ 12,000" "$ 1,200,000" |
Date et heure
- À 2:37:47 PM le Lundi 23 novembre 2015
- Fuseau horaire États-Unis, Pacifique (UTC-8)
| Formule | Description | Résultat |
|---|---|---|
| Text( Now(), DateTimeFormat.LongDate ) | Met en forme comme chaîne de date longue, dans la langue et les paramètres régionaux de l’utilisateur actuel. | « Lundi 23 novembre 2015 » |
| Text( Now(), DateTimeFormat.LongDateTime ) | Met en forme comme chaîne de date/heure longue, dans la langue et les paramètres régionaux de l’utilisateur actuel, à l’aide du format de 12 heures. | « Lundi 23 novembre 2015 2:37:47 PM » |
| Text( Now(), DateTimeFormat.LongTime24 ) | Met en forme comme chaîne d’heure longue, en utilisant le format de 24 heures. | « 14:37:47 » |
| Text( Now(), DateTimeFormat.ShortDate ) | Met en forme comme chaîne de date courte, dans la langue et les paramètres régionaux de l’utilisateur actuel. | « 11/23/2015 » |
| Text( Now(), "d-mmm-yy" ) | Met en forme à l’aide d’espaces réservés :
|
« 23 nov 15 » |
| Text(1448318857*1000, "mmm. dd, yyyy (hh:mm:ss AM/PM)") | Affiche une valeur date-heure Unix au format lisible par l’homme si vous multipliez la valeur source par 1 000. | « 23 nov 2015 (02:47:37 PM) » |
Applications à l’échelle mondiale
| Formule | Description | Result |
|---|---|---|
| Text(1234567.89, "[$-fr-FR]# ###,## €", "fr-FR") | Affiche un espace comme séparateur de regroupement, la virgule comme séparateur décimal et € comme symbole monétaire. | "1 234 567,89 €" |
| Text(1234567,89; "[$-fr-FR]# ###,## €") | Si les données source suivent la coutume française d’utiliser une virgule comme séparateur décimal, vous devez changer vos paramètres régionaux en français et séparer les arguments par un point-virgule au lieu d’une virgule pour obtenir le même résultat que ci-dessus. | "1 234 567,89 €" |
| Text( Date(2016,1,31), "dddd mmmm d" ) | Renvoie le jour de la semaine, le mois et le jour du mois dans la langue de l’utilisateur actuel. Comme aucun des espaces réservés n’est dépendant de la langue, aucune balise de langue de texte de format n’est nécessaire. | "Sunday January 31" |
| Text( Date(2016,1,31), "dddd mmmm d", "es-ES" ) | Renvoie le jour de la semaine, le mois et le jour du mois dans la langue « es-ES ». | "domingo enero 31" |
Conversion de valeurs en texte
| Formule | Description | Résultat |
|---|---|---|
| Text( 1234567.89 ) | Convertit un nombre en chaîne. Il n’y a pas de milliers de séparateurs ni de contrôle sur le nombre de chiffres avant ou après le séparateur décimal ; pour plus de contrôle, fournissez des espaces réservés de nombre comme deuxième argument. | « 1234567,89 » |
| Text( DateTimeValue( "01/04/2003" ) ) | Convertit une valeur de date/heure en une chaîne de texte. Pour contrôler la conversion, fournissez un membre de l’énumération DateTimeFormat ou une chaîne de format personnalisé. | « 1/4/2003 12:00 AM » |
| Text( true ) | Convertit une valeur booléenne en chaîne. | « true » |
| Text( GUID() ) | Convertit une valeur GUID générée en chaîne. | "f8b10550-0f12-4f08-9aa3-bb10958bc3ff" |
| Left( Text( GUID() ), 4 ) | Renvoie les quatre premiers caractères d’un GUID généré. | « 2d9c » |