Fonction Text dans PowerAppsText function in PowerApps

Met en forme un nombre ou une valeur de date/heure pour un affichage sous forme de chaîne de texte.Formats a number or a date/time value for display as a string of text.

DescriptionDescription

La fonction Text met en forme un nombre ou une valeur de date/heure en fonction de l’un de ces types d’arguments :The Text function formats a number or a date/time value based on one of these types of arguments:

  • Un format de date/heure prédéfini que vous spécifiez à l’aide de l’énumération DateTimeFormat.A predefined date/time format, which you specify by using the DateTimeFormat enumeration. Pour les dates et heures, cette approche est recommandée, car elle s’adapte automatiquement à la langue et à l’emplacement de chaque utilisateur.For dates and times, this approach is preferred as it automatically adjusts to each user's language and location.
  • 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.A custom format, a string of text that comprises placeholders that describe how to format the number or the date/time value. 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.Placeholders define how many digits to show, whether grouping separators should be used, and how to display the name of a month. PowerApps prend en charge un sous-ensemble des espaces réservés de Microsoft Excel.PowerApps supports a subset of the placeholders that Microsoft Excel does.

Pour plus d’informations, voir Utilisation des dates et heures.See working with dates and times for more information.

Formats de date et d’heure prédéfinisPredefined date/time formats

Format prédéfiniPredefined Format DescriptionDescription
DateTimeFormat.LongDateDateTimeFormat.LongDate Année, mois, jour du mois et jour de la semaine.Full year, month, day of the month, and day of the week. Les noms du mois et du jour de la semaine ne sont pas abrégés.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTimeDateTimeFormat.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.Full year, month, day of the month, and day of the week, plus hour (12-hour clock), minutes, seconds, and AM/PM designation. Les noms du mois et du jour de la semaine ne sont pas abrégés.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongDateTime24DateTimeFormat.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.Full year, month, day of the month, and day of the week, plus hour (24-hour clock), minutes, and seconds. Les noms du mois et du jour de la semaine ne sont pas abrégés.The names of the month and the day of the week aren't abbreviated.
DateTimeFormat.LongTimeDateTimeFormat.LongTime Heure (au format 12 heures), minutes, secondes et désignation AM/PM.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Identique à ShortTime.Same as ShortTime.
DateTimeFormat.LongTime24DateTimeFormat.LongTime24 Heure (au format 24 heures), minutes, secondes.Hour (24-hour clock), minutes, seconds. Identique à ShortTime24.Same as ShortTime24.
DateTimeFormat.ShortDateDateTimeFormat.ShortDate Année à quatre chiffres, mois à deux chiffres et jour du mois.Four-digit year with two-digit month and day of the month.
DateTimeFormat.ShortDateTimeDateTimeFormat.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.Four-digit year with two-digit month and day of the month, plus hour (12-hour clock), minutes, seconds, and AM/PM designation.
DateTimeFormat.ShortDateTime24DateTimeFormat.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.Four-digit year with two-digit month and day of the month, plus hour (24-hour clock), minutes, and seconds.
DateTimeFormat.ShortTimeDateTimeFormat.ShortTime Heure (au format 12 heures), minutes, secondes et désignation AM/PM.Hour (12-hour clock), minutes, seconds, and AM/PM designation. Identique à LongTime.Same as LongTime.
DateTimeFormat.ShortTime24DateTimeFormat.ShortTime24 Heure (au format 24 heures), minutes et secondes.Hour (24-hour clock), minutes, and seconds. Identique à LongTime24.Same as LongTime24.
DateTimeFormat.UTCDateTimeFormat.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.The date/time value is converted to UTC based on the current user's time zone and formatted according to the ISO 8601 standard.

Espaces réservés numériquesNumber placeholders

Espace réservéPlaceholder DescriptionDescription
0 (zéro)0 (zero) Affiche des zéros non significatifs si un nombre contient moins de chiffres que de zéros dans le format.Displays insignificant zeros if a number has fewer digits than there are zeros in the format. Par exemple, utilisez le format #.00 si vous souhaitez afficher 8.9 comme suit : 8.90.For example, use the format #.00 if you want to display 8.9 as 8.90.
# Suit les mêmes règles que 0 (zéro).Follows the same rules as the 0 (zero). 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.However, Text doesn't return extra zeros when the number has fewer digits on either side of the decimal than there are # symbols in the format. Par exemple, 8.9 s’affiche si le format personnalisé est #.## et le nombre à mettre en forme est 8.9.For example, 8.9 is displayed if the custom format is #.## and the number to format is 8.9.
.. (point)(period) Affiche la décimale dans un nombre.Displays the decimal point in a number. Dépend de la langue du format personnalisé. Pour plus d’informations, voir Applications à l’échelle mondiale.Depends on the language of the custom format, see global apps for more details.
, (virgule), (comma) Affiche le séparateur de regroupement dans un nombre, souvent utilisé pour les milliers.Displays the grouping separator in a number, often used for thousands. 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.Text separates groups by commas if the format contains a comma that's enclosed by number signs (#) or by zeros. Dépend de la langue du format personnalisé. Pour plus d’informations, voir Applications à l’échelle mondiale.Depends on the language of the custom format, see global apps for more details.

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.If a number has more digits to the right of the decimal point than there are placeholders in the format, the number rounds to as many decimal places as there are placeholders. 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.If there are more digits to the left of the decimal point than there are placeholders, the extra digits are displayed. 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).If the format contains only number signs (#) to the left of the decimal point, numbers less than 1 start with a decimal point (for example, .47).

Espaces réservés de date et heureDate and time placeholders

Espace réservéPlaceholder DescriptionDescription
mm Affiche le mois sous la forme d’un nombre sans zéro non significatif.Displays the month as a number without a leading zero.
mmmm Affiche le mois sous la forme d’un nombre avec un zéro non significatif, le cas échéant.Displays the month as a number with a leading zero when appropriate.
mmmmmm Affiche le mois sous forme abrégée (Jan à Dec).Displays the month as an abbreviation (Jan to Dec).
mmmmmmmm Affiche le mois sous forme non abrégée (January à December).Displays the month as a full name (January to December).
dd Affiche le jour sous la forme d’un nombre sans zéro non significatif.Displays the day as a number without a leading zero.
dddd Affiche le jour sous la forme d’un nombre avec un zéro non significatif, le cas échéant.Displays the day as a number with a leading zero when appropriate.
dddddd Affiche le jour sous forme abrégée (Sun à Sat).Displays the day as an abbreviation (Sun to Sat).
dddddddd Affiche le jour en entier (Sunday à Saturday).Displays the day as a full name (Sunday to Saturday).
yyyy Affiche l’année sous la forme d’un nombre à deux chiffres.Displays the year as a two-digit number.
yyyyyyyy Affiche l’année sous la forme d’un nombre à quatre chiffres.Displays the year as a four-digit number.
hh Affiche l’heure sous la forme d’un nombre sans zéro non significatif.Displays the hour as a number without a leading zero.
hhhh Affiche l’heure sous la forme d’un nombre avec un zéro non significatif, le cas échéant.Displays the hour as a number with a leading zero when appropriate. Si le format contient AM ou PM, l’heure est présentée au format 12 heures.If the format contains AM or PM, the hour is shown based on the 12-hour clock. Sinon, l’heure est présentée au format 24 heures.Otherwise, the hour is shown based on the 24-hour clock.
mm Affiche la minute sous la forme d’un nombre sans zéro non significatif.Displays the minute as a number without a leading zero. 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.Note: The m or the mm code must appear immediately after the h or hh code or immediately before the ss code; otherwise, Text returns the month instead of minutes.
mmmm Affiche la minute sous la forme d’un nombre avec un zéro non significatif, le cas échéant.Displays the minute as a number with a leading zero when appropriate. 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.Note: The m or the mm placeholder must appear immediately after the h or hh placeholder or immediately before the ss placeholder. Sinon, la fonction Text renvoie le mois au lieu de minutes.Otherwise, Text returns the month instead of minutes.
ss Affiche la seconde sous la forme d’un nombre sans zéro non significatif.Displays the second as a number without a leading zero.
ssss Affiche la seconde sous la forme d’un nombre avec un zéro non significatif, le cas échéant.Displays the second as a number with a leading zero when appropriate.
ff Affiche les fractions de secondes.Displays the fractions of seconds.
AM/PM, am/pm, A/P, a/pAM/PM, am/pm, A/P, a/p Affiche l’heure au format 12 heures.Displays the hour based on a 12-hour clock. 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.Text returns "AM", "am", "A", or "a" for times from midnight until noon and "PM", "pm", "P", or "p" for times from noon until midnight

Espaces réservés pour les littérauxLiteral placeholders

Vous pouvez inclure les caractères suivants dans votre chaîne de format.You can include any of these characters in your format string. Ceux-ci s’affichent dans le résultat de la fonction Text en l’état.They will appear in the result of Text as is. Les caractères supplémentaires sont réservés à de futurs espaces réservés. Ne les utilisez pas.Additional characters are reserved for future placeholders, so you shouldn't use them.

CaractèreCharacter DescriptionDescription
Symbole de deviseAny currency symbol Dollar, Centimes, Euro, etc.Dollar sign, cents sign, euro sign, etc.
+ Signe PlusPlus sign
(( Parenthèse gaucheLeft parenthesis
:: Deux-pointsColon
^ Accent circonflexeCircumflex accent (caret)
'' ApostropheApostrophe
{{ Accolade gaucheLeft curly bracket
< Signe Inférieur àLess-than sign
= Signe Égal àEqual sign
- Signe MoinsMinus sign
/ Barre obliqueSlash mark
)) Parenthèse droiteRight parenthesis
& Et commercialAmpersand
~ TildeTilde
}} Accolade droiteRight curly bracket
> Signe Supérieur àGreater-than sign
  EspaceSpace character

Applications à l’échelle mondialeGlobal apps

La fonction Text reconnaît toutes les langues.The Text function is globally aware. Pour un grand nombre de langues, elle sait comment écrire correctement les dates, heures, devises et nombres.For a wide array of languages, it knows how to properly write out dates, times, currencies, and numbers. Pour faire son travail, elle a besoin de deux informations :To do its job, it needs two pieces of information:

  • La langue du format personnalisé : pour les auteurs, comment doit être interprété un format personnalisé ?The language of the custom format: For authors, how should a custom format be interpreted? Les caractères de séparation (.The separator characters (. et ,) ont des significations différentes selon la langue.and ,) have different meanings in different languages. Pour gérer cela, il existe un espace réservé spécial qui contient une balise de langue.This is handled with a special placeholder containing a language tag. Plus simple encore, les formats de date/heure prédéfinis sont indépendants du langage.Even easier, the predefined date/time formats are language agnostic.
  • La langue du résultat : pour les utilisateurs, quelle langue doit être utilisée dans le résultat de la fonction ?The language of the result: For users, what language should be used in the result of the function? Les noms des mois et des jours de la semaine doivent se trouver dans la langue de l’utilisateur de l’application.Names for months and weekdays need to be in the appropriate language for the user of the app. Ceci est géré avec un troisième argument facultatif de la fonction Text.This is handled with a third optional argument to the Text function.

Dans les deux cas, la langue est fournie avec une balise de langue.For both, the language is provided with a language tag. 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.To see the list of supported languages type Text( 1234, "", ) in the formula bar or advanced view and scroll through the list of locales suggested for the third argument.

Espace réservé de langue pour le format personnaliséCustom format language placeholder

Pour spécifier la langue du format personnalisé, utilisez :To specify the language of the custom format, use:

Espace réservéPlaceholder DescriptionDescription
[$-LanguageTag][$-LanguageTag] LanguageTag est une balise de langue, comme renvoyée par la fonction Language.LanguageTag is a language tag as returned from the Language function. 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.It can be in the form of just the language such as [$-en] for English, or it can also include the region such as [$-en-GB] to further specify Great Britain.

L’espace réservé de langue peut apparaître n’importe où dans le format personnalisé, mais une seule fois.The language placeholder can appear anywhere in the custom format but only once.

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.While writing a formula, if you do not provide a language placeholder and the format string is ambiguous from a global standpoint, the authoring tool will automatically insert the language tag for your current language.

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.[$-en-US] is assumed if this placeholder is not present when your app is run.

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.NOTE: In a future version, the syntax of this placeholder may change to avoid confusion with a similar, but different, placeholder supported by Excel.

Balise de langue de résultatResult language tag

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.Appearing in the result of Text are translated strings for month, weekday, and AM/PM designations, as well as the appropriate group and decimal separators.

Par défaut, la fonction Text utilise la langue de l’utilisateur exécutant l’application.By default, Text uses the language of the user running the app. La fonction Language renvoie la balise de langue pour l’utilisateur actuel.The Language function returns the language tag for the current user. Vous pouvez remplacer cette valeur par défaut en fournissant une balise de langue pour le troisième argument facultatif de la fonction Text.You can override this default by supplying a language tag for the optional third argument to Text.

SyntaxeSyntax

Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )Text( Number, DateTimeFormatEnum [, ResultLanguageTag ] )

  • Number - Requis.Number - Required. Nombre ou valeur de date/heure à mettre en forme.The number or the date/time value to format.
  • DateTimeFormat - Requis.DateTimeFormat - Required. Membre de l’énumération DateTimeFormat.A member of the DateTimeFormat enumeration.
  • ResultLanguageTag - Facultatif.ResultLanguageTag - Optional. Balise de langue à utiliser pour le texte de résultat.The language tag to use for the result text. Par défaut, la langue de l’utilisateur actuel est utilisée.By default, the language of the current user is used.

Text( Number, CustomFormat [, ResultLanguageTag ] )Text( Number, CustomFormat [, ResultLanguageTag ] )

  • Number - Requis.Number - Required. Nombre ou valeur de date/heure à mettre en forme.The number or the date/time value to format.
  • CustomFormat - Requis.CustomFormat - Required. Un ou plusieurs espaces réservés entourés de guillemets doubles.One or more placeholders enclosed in double quotation marks.
  • ResultLanguageTag - Facultatif.ResultLanguageTag - Optional. Balise de langue à utiliser pour le texte de résultat.The language tag to use for the result text. Par défaut, la langue de l’utilisateur actuel est utilisée.By default, the language of the current user is used.

ExemplesExamples

L’utilisateur qui exécute ces formules se trouve aux États-Unis et a sélectionné l’anglais comme langue.The user running these formulas is located in the United States and has selected English as their language. La fonction Language renvoie la valeur « en-US ».The Language function is returning "en-US".

NombreNumber

FormuleFormula DescriptionDescription RésultatResult
Text( 1234.59, "####.#" )Text( 1234.59, "####.#" ) Met en forme le nombre avec une décimale.Formats the number with one decimal place. "1234.6""1234.6"
Text( 8.9, "#.000" )Text( 8.9, "#.000" ) Remplit la partie décimale du nombre avec des zéros, si nécessaire.Pads the decimal portion of the number with trailing zeros, if needed. "8.900""8.900"
Text( 0.631, "0.#" )Text( 0.631, "0.#" ) Remplit la partie entière du nombre avec des zéros non significatifs, si nécessaire.Pads the whole portion of the number with leading zeros, if needed. "0.6""0.6"
Text( 12, "#.0#" )Text( 12, "#.0#" )
Text( 1234.568, "#.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.Pads the decimal portion of the number with zeros for one decimal place, and includes a second decimal place if supplied. "12.0""12.0"
"1234.57""1234.57"
Text( 12000, "$ #,###" )Text( 12000, "$ #,###" )
Text( 1200000, "$ #,###" )Text( 1200000, "$ #,###" )
Place un séparateur de milliers tous les trois chiffres et inclut un symbole monétaire.Places a thousands separator every three digits, and includes a currency symbol. "$ 12,000""$ 12,000"
"$ 1,200,000""$ 1,200,000"

Date/heureDate/Time

  • À 2:37:47 PM le Monday, November 23, 2015At 2:37:47 PM on Monday, November 23, 2015
  • Fuseau horaire États-Unis, Pacifique (UTC-8)United States Pacific Time Zone (UTC-8)
FormuleFormula DescriptionDescription RésultatResult
Text( Now(), DateTimeFormat.LongDate )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.Formats as a long date string, in the language and locale of the current user. "Monday, November 23, 2015""Monday, November 23, 2015"
Text( Now(), DateTimeFormat.LongDateTime )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.Formats as a long date and time string, in the language and locale of the current user, using a 12-hour clock. "Monday, November 23, 2015 2:37:47 PM""Monday, November 23, 2015 2:37:47 PM"
Text( Now(), DateTimeFormat.LongTime24 )Text( Now(), DateTimeFormat.LongTime24 ) Met en forme comme chaîne d’heure longue, en utilisant le format de 24 heures.Formats as a long time string, using a 24-hour clock. "14:37:47""14:37:47"
Text( Now(), DateTimeFormat.ShortDate )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.Formats as a short date string, in the language and locale of the current user. "11/23/2015""11/23/2015"
Text( Now(), "d-mmm-yy" )Text( Now(), "d-mmm-yy" ) Met en forme à l’aide d’espaces réservés :Formats using placeholder characters:
  • d pour un jour à un ou deux chiffres du moisd for a single-digit or double-digit day of the month
  • - comme caractère littéral copié dans le résultat- as a literal character copied to the result
  • mmm comme abréviation à trois lettres du moismmm for a three-letter abbreviation of the month
  • - comme autre caractère littéral copié dans le résultat- as another literal character copied to the result
  • yy pour une abréviation à deux chiffres de l’annéeyy for a two-digit abbreviation of the year
"23-Nov-15""23-Nov-15"

Applications à l’échelle mondialeGlobal apps

FormuleFormula DescriptionDescription RésultatResult
Text( 1234567.89, "[$-en-US]$ #,###" )Text( 1234567.89, "[$-en-US]$ #,###" ) Interprète , comme séparateur de regroupement placé tous les trois caractères et $ comme symbole de devise.Interprets , as a grouping separator placed every three characters and $ as the currency symbol. Lorsqu’il n’y a pas de décimales à afficher, la valeur est arrondie au nombre entier supérieur suivant.As no decimals are to be displayed, the value is rounded up to the next higher whole number. [$-en-US] est facultatif dans ce cas, car il s’agit de la valeur par défaut.The [$-en-US] is optional in this case, as this is the default. "$ 1,234,568""$ 1,234,568"
Text( 1234567.89, "[$-es-ES]€ #,###" )Text( 1234567.89, "[$-es-ES]€ #,###" ) Interprète , comme séparateur décimal et comme symbole de devise.Interprets , as a decimal separator and as the currency symbol. É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 » : .Because the [$-fr-FR] only determines how the format string is interpreted, the result will use the characters from the default "en-US" lanugage tag: . (point) comme séparateur décimal et $ comme symbole de devise.(period) for decimal separator and $ for currency symbol. "$ 1234567.89""$ 1234567.89"
Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" )Text( 1234567.89, "[$-es-ES]€ #,###", "es-ES" ) Interprète , comme un séparateur décimal.Interprets , as a decimal separator. 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.The result language tag has been set to "fr-FR" which will result in , (comma) being used as the decimal separator and as the currency symbol. "€ 1234567,89""€ 1234567,89"
Text( Date(2016,1,31), "dddd mmmm d" )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.Returns the weekday, month, and day of the month in the language of the current user. 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.Because none of the placeholders are language dependent, there is no need for a format text language tag. "Saturday January 31""Saturday January 31"
Text( Date(2016,1,31), "dddd mmmm d", "es-ES" )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 ».Returns the weekday, month, and day of the month in the "es-ES" language. "domingo enero 31""domingo enero 31"