Lire en anglais

Partager via


FORMAT

s’applique à :colonne calculéetable calculéeMeasurecalcul visuel

Convertit un value en texte en fonction de la formatspécifiée.

Syntaxe

FORMAT(<value>, <format_string>[, <locale_name>])

Paramètres

Terme Définition
value Expression valueor qui prend la valeur d’une valueunique.
format_string Chaîne avec le modèle de mise en forme.
locale_name (Facultatif) Nom des paramètres régionaux à utiliser par la fonction. Les values possibles sont des chaînes acceptées par la fonction API Windows LocaleNameToLCID().

Retourner value

Chaîne contenant value mise en forme telle que définie par format_string.

Notes

If value est BLANK, la fonction retourne une chaîne vide.

If format_string est BLANK, le value est mis en forme avec un « Numéro général » or « Dategénéral » format (selon value type de données).

Remarques

  • Les chaînes format prédéfinies utilisent la propriété de culture du modèle lors de la mise en forme du résultat. Par défaut, la propriété de culture du modèle est définie en fonction des paramètres régionaux de l’utilisateur de l’ordinateur. Pour les nouveaux modèles Power BI Desktop, la propriété de culture de modèle peut être modifiée dans Options > Paramètres régionaux > langue du modèle. Pour Analysis Services, la culture du modèle est définie en fonction de la propriété Language initialement définie par l’instance.

  • Les chaînes format prises en charge comme argument de la fonction DAXFORMAT sont basées sur les chaînes format utilisées par Visual Basic (OLE Automation), not sur les chaînes format utilisées par le .NET Framework. Par conséquent, vous pouvez obtenir des résultats inattendus or un errorif l’argument ne correspond à aucune chaîne définie format. Par exemple, « p » comme abréviation de « Percent » n’est pas prise en charge. Les chaînes que vous fournissez en tant qu’argument pour la fonction FORMAT qui ne sont pas incluses dans la liste des chaînes prédéfinies format sont gérées dans le cadre d’une chaîne de format personnalisée, or en tant que littéral de chaîne.

  • Pour en savoir plus sur la spécification de paramètres régionaux avec FORMAT, consultez cette vidéo .

  • L’utilisation de FORMAT modifie un résultat measure en type de données texte. If le résultat measure est initialement de type de données numérique, puis avec FORMAT, le measure ne peut pas être utilisé sur les visuels où la section values nécessite un type de données numérique, comme avec des graphiques. Dans Power BI, vous pouvez également utiliser chaînes de format dynamiques pour les mesures spécifier une chaîne de format conditionnelle qui gère le type de données numérique du measure.

  • Cette fonction est not prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées or règles de sécurité au niveau des lignes (RLS).

Exemples

chaînes Format

= FORMAT( 12345.67, "General Number")  
= FORMAT( 12345.67, "Currency")  
= FORMAT( 12345.67, "Fixed")  
= FORMAT( 12345.67, "Standard")  
= FORMAT( 12345.67, "Percent")  
= FORMAT( 12345.67, "Scientific")

Retourne:

12345.67 « Numéro général » affiche le nombre sans mise en forme.

12 345,67 $ «Currency» affiche le nombre avec la mise en forme des paramètres régionaux de votre currency. Le sample ici affiche la mise en forme par défaut des États-Unis currency.

12345,67 «Fixed» affiche au moins un chiffre au left du séparateur décimal and deux chiffres au right du séparateur décimal.

12 345,67 « Standard » affiche au moins un chiffre au left du séparateur décimal and deux chiffres au right du séparateur décimal, and inclut des milliers de séparateurs. Le sample ici affiche la mise en forme par défaut des numéros des États-Unis.

1 234 567,00 % « Pourcentage » affiche le nombre en pourcentage (multiplié par 100) avec une mise en forme and le pourcentage sign au right du nombre séparé par un espace unique.

1,23E+04 « Scientifique » affiche le nombre en notation scientifique avec deux chiffres décimaux.

Datetime avec locale_name facultatif

= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-US" ) 
= FORMAT( dt"2020-12-15T12:30:59", BLANK(), "en-GB" ) 
= FORMAT( dt"2020-12-15T12:30:59", "mm/dd/yyyy", "en-GB" )

Retourne:

12/15/2020 12:30:59 Où month précède dayandtime est 12-hourformat.

15/12/2020 12:30:59 Where day précède monthandtime is 24-hourformat.

12/15/2020 12:30:59 Where month précède dayandtime is 24-hourformat. Étant donné qu’une chaîne format non dépendante des paramètres régionaux est spécifiée, les paramètres régionaux sont not appliqués and les format non régionaux sont retournés.

Formats numériques prédéfinis

Les formats numériques prédéfinis suivants peuvent être spécifiés dans l’argument format_string :

Format Description
"General Number" Affiche le nombre sans milliers de séparateurs.
"Currency" Affiche le nombre avec des séparateurs de milliers, if approprié ; affiche deux chiffres au right du séparateur décimal. La sortie est basée sur les paramètres régionaux système.
"Fixed" Affiche au moins un chiffre au leftand deux chiffres au right du séparateur décimal.
"Standard" Affiche le nombre avec des séparateurs de milliers, au moins un chiffre à la leftand deux chiffres au right du séparateur décimal.
"Percent" Affiche le nombre multiplié par 100 par un pourcentage sign (%) ajouté immédiatement au right; affiche toujours deux chiffres au right du séparateur décimal.
"Scientific" Utilise la notation scientifique standard, fournissant deux chiffres significatifs.
"Yes/No" Affiche aucun nombre if est 0 ; sinon, affiche Oui.
"True/False" Affiche Falseif nombre est 0 ; sinon, affiche True.
"On/Off" Affiche désactivé if nombre est 0 ; sinon, affiche Activé.

Formats numériques personnalisés

Une expression format personnalisée pour les nombres peut avoir de un à trois sections séparées par des points-virgules. If l’argument de chaîne formatcontains l’un des formats numériques nommés, une seule section est autorisée.

If vous utilisez Le résultat est
Une seule section L’expression format s’applique à allvalues.
Deux sections La section first s’applique aux zéros positifs valuesand, les second à des valuesnégatives.
Trois sections La section first s’applique à des valuespositifs , le second à des valuesnégatifs , and le troisième à zéros.
"$#,##0;($#,##0)"

If vous incluez des points-virgules sans rien entre eux, la section manquante est définie à l’aide de la format du valuepositif. Par exemple, la format suivante affiche des values négatives and positives à l’aide du format dans la section firstand affiche « Zéro » if la value est égale à zéro.

"$#,##0"

If vous incluez des points-virgules avec rien entre eux, la section manquante s’affiche à l’aide de la format du valuepositif.

Caractères de format numériques personnalisés

Les caractères de format numériques personnalisés suivants peuvent être spécifiés dans l’argument format_string :

Personnage Description
None Affichez le nombre sans mise en forme.
(0) Espace réservé numérique. Afficher un chiffre or un zéro. If l’expression a un chiffre dans la position où le 0 apparaît dans la chaîne format, affichez-la ; sinon, affichez un zéro dans cette position.If le nombre comporte moins de chiffres qu’il y a des zéros (sur l’un ou l’autre côté de la décimale) dans l’expression format, affichant les zéros de début or de fin. If le nombre a plus de chiffres à la right du séparateur décimal qu’il y a des zéros à l'right du séparateur décimal dans l’expression format, round le nombre à autant de décimales qu’il y a zéros. If le nombre a plus de chiffres à la left du séparateur décimal qu’il y a des zéros au left du séparateur décimal dans l’expression format, afficher les chiffres supplémentaires sans modification.
(#) Espace réservé numérique. Affichez un chiffre or rien. If l’expression a un chiffre dans la position où le # apparaît dans la chaîne format, affichez-la ; sinon, n’affichez rien dans cette position. Ce symbole fonctionne comme l’espace réservé à 0 chiffres, except que les zéros de début and de fin ne sont pas affichés if le nombre a le même or moins de chiffres qu’il y a des caractères # de l’un des deux côtés du séparateur décimal dans l’expression format.
(.) Espace réservé décimal. Dans certains paramètres régionaux, une virgule est utilisée comme séparateur décimal. L’espace réservé décimal détermine le nombre de chiffres affichés dans la leftandright du séparateur décimal. If l’expression formatcontains signes numériques uniquement aux left de ce symbole, les nombres inférieurs à 1 commencent par un séparateur décimal. Pour afficher un zéro non significatif affiché avec des nombres fractionnaires, utilisez 0 comme espace réservé au chiffre first à l'left du séparateur décimal. Le caractère réel utilisé comme espace réservé décimal dans la sortie mise en forme dépend du nombre Format reconnu par votre système.
(%) Espace réservé de pourcentage. L’expression est multipliée par 100. Le caractère pourcentage (%) est inséré dans la position où il apparaît dans la chaîne format.
(,) Mille séparateurs. Dans certains paramètres régionaux, une période est utilisée comme séparateur de milliers. Le séparateur de milliers sépare des milliers de centaines au sein d’un nombre qui a quatre or plus d’endroits à la left du séparateur décimal. L’utilisation standard du séparateur de milliers est spécifiée if l'formatcontains un séparateur de milliers entouré d’espaces réservés à chiffres (0or#). Deux séparateurs de milliers adjacents or un séparateur de milliers immédiatement à l'left du séparateur décimal (si ornot une décimale est spécifiée) signifie « mettre à l’échelle le nombre en le divisant par 1 000, arrondi selon les besoins ». Par exemple, vous pouvez utiliser la chaîne format « ##0 », pour représenter 100 millions comme 100 millions. Les nombres inférieurs à 1 million sont affichés sous la forme 0. Deux séparateurs de milliers adjacents dans n’importe quelle position autre que immédiatement à la left du séparateur décimal sont traités simplement comme spécifiant l’utilisation d’un séparateur de milliers. Le caractère réel utilisé comme séparateur de milliers dans la sortie mise en forme dépend du nombre Format reconnu par votre système.
(:) Time séparateur. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur time. Le séparateur time sépare les heures, les minutes and secondes lorsque timevalues sont mises en forme. Le caractère réel utilisé comme séparateur time dans la sortie mise en forme est déterminé par vos paramètres système.
(/) Date séparateur. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur date. Le séparateur date sépare le day, month, andyear lorsque datevalues sont mis en forme. Le caractère réel utilisé comme séparateur date dans la sortie mise en forme est déterminé par vos paramètres système.
(E- E+ e- e+) Scientifique format. If l’expression formatcontains au moins un espace réservé à un chiffre (0or#) au right de E-, E+, e-, e+, or e+, le nombre est affiché dans le formatandor scientifique e est inséré entre le nombre and son exposant. Le nombre d’espaces réservés à la right détermine le nombre de chiffres dans l’exposant. Utilisez E- or e- pour placer un moins signnext aux exposants négatifs. Utilisez E+ or e+ pour placer un moins signnext aux exposants négatifs and un plus signnext aux exposants positifs.
- + $ ( ) Afficher un caractère littéral. Pour afficher un caractère autre que l’un de ceux répertoriés, faites-le précéder d’une barre oblique inverse (\) or placez-le entre guillemets doubles ( » « ).
(\\) Affichez le caractère next dans la chaîne format. Pour afficher un caractère qui a une signification spéciale en tant que caractère littéral, faites-le précéder d’une barre oblique inverse (\). La barre oblique inverse elle-même n’est pas affichée. L’utilisation d’une barre oblique inverse est la même que le caractère next entre guillemets doubles. Pour afficher une barre oblique inverse, utilisez deux barres obliques inverses (\\). Exemples de caractères qui ne peuvent pas être affichés en tant que caractères littéraux sont les date-mise en forme andtime-formatage des caractères (a, c, d, h, m, n, p, q, s, t, w, y, /, and :), les caractères de mise en forme numérique (#, 0, %, E, e, virgule, and point), and les caractères de mise en forme de chaîne (@, &, <, >, and !).
(« ABC ») Affichez la chaîne entre guillemets doubles ( » « ).

Formats date/time prédéfinis

Les formats date/time prédéfinis suivants peuvent être spécifiés dans l’argument format_string. Lorsque vous utilisez des formats autres que ceux-ci, ils sont interprétés comme un datepersonnalisé /timeformat:

Format Description
"General Date" Affiche un dateand/ortime. Par exemple, 3/12/2008 11:07:31 AM. Date'affichage est déterminé par la culture actuelle de votre application value.
"Long Date" or "Medium Date" Affiche une date en fonction de la longue dateformatde votre culture actuelle. Par exemple, mercredi 12 mars 2008.
"Short Date" Affiche un date à l’aide de la dateformatcourte de votre culture actuelle. Par exemple, 3/12/2008.
"Long Time" or Affiche un time à l’aide de la longue timeformatde votre culture actuelle ; inclut généralement des heures, des minutes, des secondes. Par exemple, 11:07:31 AM.
"Medium Time" Affiche une time dans 12 hourformat. Par exemple, 11h07.
"Short Time" Affiche une time en 24 hourformat. Par exemple, 11:07.

Formats date/time personnalisés

Les caractères format suivants peuvent être spécifiés dans le format_string pour créer des formats date/time personnalisés :

Personnage Description
(:) Time séparateur. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur time. Le séparateur time sépare les heures, les minutes and secondes lorsque timevalues sont mises en forme. Le caractère réel utilisé comme séparateur time dans la sortie mise en forme est déterminé par vos paramètres système.
(/) Date séparateur. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur date. Le séparateur date sépare le day, month, andyear lorsque datevalues sont mis en forme. Le caractère réel utilisé comme séparateur date dans la sortie mise en forme est déterminé par vos paramètres système.
(\) Backslash. Affiche le caractère next en tant que caractère littéral. Il est donc not interprété comme un caractère de mise en forme.
(") Guillemets doubles. Le texte placé entre guillemets doubles s’affiche. Il est donc not interprété comme des caractères de mise en forme.
c Affichez le date comme dddddand afficher le time en tant que ttttt, dans cet ordre. Affichez uniquement les informations dateif il n’existe aucune partie fractionnelle au numéro de série date ; affiche uniquement time informations if il n’y a aucune partie entière.
d Affichez la day sous la forme d’un nombre sans zéro non significatif (1 à 31).
dd Affichez la day sous forme de nombre avec un zéro non significatif (01-31).
ddd Affichez la day sous forme d’abréviation (Sun-Sat). Localisée.
dddd Affichez le day sous la forme d’un nom complet (Sunday-Saturday). Localisée.
ddddd Affichez le date sous la forme d’un date complet (y compris day, month, andyear), mis en forme en fonction du paramètre de dateformat court de votre système. La dateformat courte par défaut est mm/dd/yyyy.
dddddd Affichez un numéro de série date en tant que date complet (y compris day, month, andyear) mis en forme en fonction du paramètre long date reconnu par votre système. La dateformat longue par défaut est dddd, mmmm d, yyyy.
w Affichez la day de la semaine sous la forme d’un nombre (1 pour dimanche à 7 pour samedi).
ww Affichez la semaine du year sous la forme d’un nombre (1 à 54).
m Affichez la month sous la forme d’un nombre sans zéro non significatif (1 à 12). If m suit immédiatement horhh, minute plutôt que le month s’affiche.
mm Affichez la month sous forme de nombre avec un zéro non significatif (01-12). If mm suit immédiatement horhh, minute plutôt que le month s’affiche.
mmm Affichez la month sous forme d’abréviation (Jan-Dec). Localisée.
mmmm Affichez le month sous la forme d’un nom de month complet (January-December). Localisée.
q Affichez la quarter du year sous la forme d’un nombre (1 à 4).
y Affichez la day du year sous la forme d’un nombre (1 à 366).
yy Affichez le year sous la forme d’un nombre à 2 chiffres (00-99).
yyyy Affichez le year sous la forme d’un nombre à 4 chiffres (100-9999).
h Affichez la hour sous la forme d’un nombre sans zéro non significatif (0-23).
hh Affichez le hour sous forme de nombre avec un zéro non significatif (00-23).
n Affichez le minute sous la forme d’un nombre sans zéro non significatif (0-59).
nn Affichez le minute sous forme de nombre avec un zéro non significatif (00-59).
s Affichez le second sous la forme d’un nombre sans zéro non significatif (0-59).
ss Affichez le second sous forme de nombre avec un zéro non significatif (00-59).
ttttt Affichez un time en tant que time complet (y compris hour, minute, andsecond), mis en forme à l’aide du séparateur time défini par le timeformat reconnu par votre système. Un zéro non significatif s’affiche if l’option zéro de début est sélectionnée and l'time est antérieure à 10h00 or P.M. La timeformat par défaut est h:mm:ss.
AM/PM Utilisez l’horloge de 12hourand afficher un am majuscule avec n’importe quelle hour avant midi ; affiche un PM majuscule avec n’importe quelle hour entre midi and 11h59 P.M.
am/pm Utilisez l’horloge de 12hourand afficher un am minuscule avec n’importe quelle hour avant midi ; affiche un PM minuscule avec n’importe quelle hour entre midi and 11h59 P.M.
A/P Utilisez l’horloge de 12hourand afficher un majuscule A avec n’importe quel hour avant midi ; affiche un P majuscule avec n’importe quel hour entre midi and 11:59 P.M.
a/p Utilisez l’horloge de 12hourand afficher une minuscule A avec n’importe quel hour avant midi ; afficher un P minuscule avec n’importe quelle hour entre midi and 11:59 P.M.
AMPM Utilisez l’horloge de 12hourand afficher le littéral de chaîne AM tel que défini par votre système avec n’importe quelle hour avant midi ; affichez le littéral de chaîne PM tel que défini par votre système avec n’importe quelle hour entre midi and 11:59 P.M. AMPM peut être en majuscules or minuscules, mais le cas de la chaîne affichée correspond à la chaîne telle que définie par vos paramètres système. La format par défaut est AM/PM. If votre système est défini sur 24hour horloge, la chaîne est généralement définie sur une chaîne vide.

Date/time mise en forme utilise les paramètres régionaux de l’utilisateur actuel pour format la chaîne. Par exemple, considérez le date le 25 juin 2020. Lorsqu’elle est mise en forme à l’aide de format chaîne « m/d/aaaa », il s’agit de :

  • Les paramètres régionaux de l’utilisateur sont des États-Unis d’Amérique (en-US) : « 6/25/2020 »
  • Paramètres régionaux de l’utilisateur est Allemagne (de-DE) : « 6.25.2020 »

Exemples de date/timeformat personnalisés

Les exemples suivants utilisent le date/time jeudi 25 juin 2020, à 13h23:45. L’Allemagne (de-DE) utilise un système de 24hour. Il n’y a pas d’équivalent d’AM/PM.

Format Résultat (en-US) Résultat (de-DE)
"c" 06/25/2020 13:23:45 25.06.2020 13:23:45
"d" 25 25
"dd" 25 25
"ddd" Thu Faire
"dddd" Jeudi Donnerstag
"ddddd" 06/25/2020 25.06.2020
"dddddd" Jeudi 25 juin 2020 Donnerstag, 25. Juni 2020
"w" 5 5
"ww" 26 26
"m" 6 6
"mm" 06 06
"mmm" Juin Juin
"mmmm" Juin Juni
"q" 2 2
"y" 177 177
"yy" 20 20
"yyyy" 2020 2020
"""Year"" yyyy" Year 2020 Year 2020
"yyyy \Qq" 2020 Q2 2020 Q2
"dd/mm/yyyy" 25/06/2020 25.06.2020
"mm/dd/yyyy" 06/25/2020 06.25.2020
"h:nn:ss" 13:23:45 13:23:45
"h:nn:ss AMPM" 1:23:45 PM 1:23:45
"hh:nn:ss" 13:23:45 13:23:45
"hh:nn:ss AMPM" 01:23:45 PM 01:23:45
"ttttt" 13:23:45 13:23:45
"ttttt AMPM" 13:23:45 PM 13:23:45
"mm/dd/yyyy hh:nn:ss AMPM" 25/06/2020 01:23:45 PM 6.25.2020 01:23:45