Met en forme un nombre ou une valeur de date/heure pour un affichage sous forme de 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 à l’emplacement de chaque utilisateur.
  • Un format personnalisé, une chaîne de texte qui comprend des espaces réservés qui décrivent comment mettre en forme le nombre ou la valeur de date/heure. Les espaces réservés définissent le nombre de chiffres à afficher, si les séparateurs de regroupement doivent être utilisés et comment afficher le nom d’un mois. PowerApps prend en charge un sous-ensemble des espaces réservés de Microsoft Excel.

Pour plus d’informations, voir Utilisation des dates et heures.

Formats de date et d’heure prédéfinis

Format prédéfini Description
DateTimeFormat.LongDate Année, 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.
DateTimeFormat.LongDateTime Année, 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.
DateTimeFormat.LongDateTime24 Année, 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.
DateTimeFormat.LongTime Heure (au format 12 heures), minutes, secondes et désignation AM/PM. Identique à ShortTime.
DateTimeFormat.LongTime24 Heure (au format 24 heures), minutes, secondes. Identique à ShortTime24.
DateTimeFormat.ShortDate Année à quatre chiffres, mois à deux chiffres et jour du mois.
DateTimeFormat.ShortDateTime Année à quatre chiffres, mois à deux chiffres, jour du mois, ainsi que l’heure (au format 12 heures), les minutes, les secondes et la désignation AM/PM.
DateTimeFormat.ShortDateTime24 Année à quatre chiffres, mois à deux chiffres et jour du mois, ainsi que l’heure (au format 24 heures), les minutes et les secondes.
DateTimeFormat.ShortTime Heure (au format 12 heures), minutes, secondes et désignation AM/PM. Identique à LongTime.
DateTimeFormat.ShortTime24 Heure (au format 24 heures), minutes et secondes. Identique à LongTime24.
DateTimeFormat.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.

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.
. (point) Affiche la décimale dans un nombre. Dépend de la langue du format personnalisé. Pour plus d’informations, voir Applications à l’échelle mondiale.
, (virgule) 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 (January à December).
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 (Sun à Sat).
dddd Affiche le jour en entier (Sunday à Saturday).
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. Remarque : le code m ou mm 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. Remarque : l’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, am/pm, A/P, a/p Affiche l’heure au format 12 heures. La fonction Text renvoie « AM », « am », « A » ou « a » pour les heures de minuit à midi et « PM », « pm », « P » 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
& Et commercial
~ 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 selon la langue. Pour gérer cela, il existe un espace réservé spécial qui contient une balise de langue. Plus simple encore, les formats de date/heure prédéfinis sont indépendants du langage.

  • 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 se trouver dans la langue de l’utilisateur de l’application. Ceci est géré avec un troisième argument facultatif de la fonction Text.

Dans les deux cas, la langue est fournie avec une balise de langue. Pour afficher la liste des langues prises en charge, tapez Text( 1234, "", ) dans la barre de formule ou l’affichage avancé et faites défiler la liste des paramètres régionaux suggérés pour le troisième argument.

Espace réservé de langue pour le format personnalisé

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 être sous la forme de la langue uniquement, comme [$-en] pour l’anglais. Elle peut également inclure 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.

Pendant que vous écrivez une formule, si vous ne fournissez pas d’espace réservé de langue et que la chaîne de format est ambiguë d’un point de vue international, l’outil de création insère automatiquement la balise de langue correspondant à la langue actuelle.

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.

REMARQUE : 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

Dans le résultat de la fonction Text, 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 facultatif de la fonction Text.

Syntaxe

Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )

  • Number - Requis. Nombre ou valeur de date/heure à mettre en forme.
  • DateTimeFormat - Requis. 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( Number, CustomFormat [, ResultLanguageTag ] )

  • Number - Requis. Nombre ou valeur de date/heure à mettre en forme.
  • CustomFormat - Requis. 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.

Exemples

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/heure

  • À 2:37:47 PM le Monday, November 23, 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. "Monday, November 23, 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. "Monday, November 23, 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 :
  • d pour un jour à un ou deux chiffres du mois
  • - comme caractère littéral copié dans le résultat
  • mmm comme abréviation à trois lettres du mois
  • - comme autre caractère littéral copié dans le résultat
  • yy pour une abréviation à deux chiffres de l’année
"23-Nov-15"

Applications à l’échelle mondiale

Formule Description Résultat
Text( 1234567.89, "[$-en-US]$ #,###" ) Interprète , comme séparateur de regroupement placé tous les trois caractères et $ comme symbole de devise. Lorsqu’il n’y a pas de décimales à afficher, la valeur est arrondie au nombre entier supérieur suivant. [$-en-US] est facultatif dans ce cas, car il s’agit de la valeur par défaut. "$ 1,234,568"
Text( 1234567.89, "[$-es-ES]€ #,###" ) Interprète , comme séparateur décimal et comme symbole de devise. Étant donné que [$-fr-FR] détermine uniquement l’interprétation de la chaîne de format, le résultat utilise les caractères de la balise de langue par défaut « en-US » : . (point) comme séparateur décimal et $ comme symbole de devise. "$ 1234567.89"
Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interprète , comme un séparateur décimal. La balise de langue de résultat a la valeur « fr-FR » qui se traduit par l’utilisation d’une virgule (,) comme séparateur décimal et de comme symbole de devise. "€ 1234567,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. "Saturday 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"