FORMAT
s’applique à :
colonne calculéetable calculéemesurecalcul visuel
Convertit une valeur en texte selon le format spécifié.
Syntaxe
FORMAT(<value>, <format_string>[, <locale_name>])
Paramètres
| Terme | Définition |
|---|---|
value |
Valeur ou expression qui prend la valeur d’une valeur unique. |
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 valeurs possibles sont des chaînes acceptées par la fonction API Windows LocaleNameToLCID(). |
Valeur de retour
Chaîne contenant value mise en forme telle que définie par format_string.
Note
Si value est BLANK, la fonction retourne une chaîne vide.
Si format_string est BLANK, la valeur est mise en forme avec un format « Nombre général » ou « Date générale » (selon value type de données).
Remarques
Les chaînes de 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 de format prises en charge comme argument de la fonction DAXFORMAT sont basées sur les chaînes de format utilisées par Visual Basic (OLE Automation), et non sur les chaînes de format utilisées par le .NET Framework. Par conséquent, vous pouvez obtenir des résultats inattendus ou une erreur si l’argument ne correspond à aucune chaîne de format définie. 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 de format prédéfinies sont gérées dans le cadre d’une chaîne de format personnalisée ou 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 de mesure en type de données texte. Si le résultat de la mesure est initialement de type de données numérique, avec FORMAT, la mesure ne peut pas être utilisée sur les visuels où la section valeurs nécessite un type de données numérique, comme avec des graphiques. Dans Power BI, vous pouvez également utiliser chaînes de format dynamique pour les mesures spécifier une chaîne de format conditionnel qui gère le type de données numérique de la mesure.
Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).
Exemples
Mettre en forme des chaînes
= 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 $ « Devise » affiche le nombre avec la mise en forme des paramètres régionaux de votre devise. L’exemple montre ici la mise en forme monétaire par défaut des États-Unis.
12345.67 « Fixe » affiche au moins un chiffre à gauche du séparateur décimal et deux chiffres à droite du séparateur décimal.
12 345,67 « Standard » affiche au moins un chiffre à gauche du séparateur décimal et deux chiffres à droite du séparateur décimal, et inclut des milliers de séparateurs. L’exemple montre ici la mise en forme par défaut des nombres américains.
1 234 567,00 % « Pourcentage » affiche le nombre en pourcentage (multiplié par 100) avec mise en forme et le signe de pourcentage à droite 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ù le mois précède le jour et l’heure est au format 12 heures.
15/12/2020 12:30:59 Où le jour précède le mois et l’heure est au format de 24 heures.
12/15/2020 12:30:59 Où le mois précède le jour et l’heure est au format de 24 heures. Étant donné qu’une chaîne de format non dépendante des paramètres régionaux est spécifiée, les paramètres régionaux ne sont pas appliqués et le format non régional est retourné.
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, le cas échéant ; affiche deux chiffres à droite du séparateur décimal. La sortie est basée sur les paramètres régionaux système. |
"Fixed" |
Affiche au moins un chiffre à gauche et deux chiffres à droite du séparateur décimal. |
"Standard" |
Affiche le nombre avec des milliers de séparateurs, au moins un chiffre à gauche et deux chiffres à droite du séparateur décimal. |
"Percent" |
Affiche le nombre multiplié par 100 par un signe de pourcentage (%) ajouté immédiatement à droite ; affiche toujours deux chiffres à droite du séparateur décimal. |
"Scientific" |
Utilise la notation scientifique standard, fournissant deux chiffres significatifs. |
"Yes/No" |
Affiche Non si le nombre est 0 ; sinon, affiche Oui. |
"True/False" |
Affiche False si le nombre est 0 ; sinon, affiche La valeur True. |
"On/Off" |
Affiche Désactivé si le nombre est 0 ; sinon, affiche Activé. |
Formats numériques personnalisés
Une expression de format personnalisée pour les nombres peut avoir de un à trois sections séparées par des points-virgules. Si l’argument de chaîne de format contient l’un des formats numériques nommés, une seule section est autorisée.
| Si vous utilisez | Le résultat est |
|---|---|
| Une seule section | L’expression de format s’applique à toutes les valeurs. |
| Deux sections | La première section s’applique aux valeurs positives et zéros, la seconde aux valeurs négatives. |
| Trois sections | La première section s’applique aux valeurs positives, à la seconde aux valeurs négatives et aux troisième à zéros. |
"$#,##0;($#,##0)"
Si vous incluez des points-virgules avec rien entre eux, la section manquante est définie à l’aide du format de la valeur positive. Par exemple, le format suivant affiche des valeurs positives et négatives à l’aide du format de la première section et affiche « Zéro » si la valeur est égale à zéro.
"$#,##0"
Si vous incluez des points-virgules avec rien entre eux, la section manquante est affichée à l’aide du format de la valeur positive.
Caractères de format numérique personnalisés
Les caractères de format numérique personnalisés suivants peuvent être spécifiés dans l’argument format_string :
| Personnage | Description |
|---|---|
| Aucun | Affichez le nombre sans mise en forme. |
(0) |
Espace réservé numérique. Afficher un chiffre ou un zéro. Si l’expression a un chiffre dans la position où le 0 apparaît dans la chaîne de format, affichez-le ; sinon, affichez un zéro dans cette position. Si le nombre a 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 de format, affichez les zéros de début ou de fin. Si le nombre a plus de chiffres à droite du séparateur décimal qu’il y a des zéros à droite du séparateur décimal dans l’expression de format, arrondissez le nombre à autant de décimales qu’il y a zéros. Si le nombre comporte plus de chiffres à gauche du séparateur décimal qu’il y a des zéros à gauche du séparateur décimal dans l’expression de format, affichez les chiffres supplémentaires sans modification. |
(#) |
Espace réservé numérique. Affichez un chiffre ou rien. Si l’expression a un chiffre dans la position où le # apparaît dans la chaîne de format, affichez-le ; sinon, n’affichez rien dans cette position. Ce symbole fonctionne comme l’espace réservé à 0 chiffres, sauf que les zéros de début et de fin ne sont pas affichés si le nombre a le même ou moins de chiffres qu’il y a des caractères # sur l’un ou l’autre côté du séparateur décimal dans l’expression de 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 à gauche et à droite du séparateur décimal. Si l’expression de format contient uniquement des signes numériques à gauche 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 premier chiffre à gauche 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 format numérique 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 de 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 emplacements ou plus à gauche du séparateur décimal. L’utilisation standard du séparateur de milliers est spécifiée si le format contient un séparateur de milliers entouré d’espaces réservés à chiffres (0 ou #). Deux séparateurs de milliers adjacents ou un séparateur de milliers immédiatement à gauche du séparateur décimal (qu’un décimal soit spécifié ou non) signifie « mettre à l’échelle le nombre en le divisant par 1 000, arrondi si nécessaire ». Par exemple, vous pouvez utiliser la chaîne de format « ##0 », pour représenter 100 millions comme 100. 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 à gauche 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 format numérique reconnu par votre système. |
(:) |
Séparateur de temps. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur de temps. Le séparateur de temps sépare les heures, les minutes et les secondes lorsque les valeurs de temps sont mises en forme. Le caractère réel utilisé comme séparateur de temps dans la sortie mise en forme est déterminé par vos paramètres système. |
(/) |
Séparateur de date. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur de date. Le séparateur de date sépare le jour, le mois et l’année où les valeurs de date sont mises en forme. Le caractère réel utilisé comme séparateur de date dans la sortie mise en forme est déterminé par vos paramètres système. |
(E- E+ e- e+) |
Format scientifique. Si l’expression de format contient au moins un espace réservé à un chiffre (0 ou #) à droite de E-, E+, e-ou e+, le nombre est affiché au format scientifique et E ou e est inséré entre le nombre et son exposant. Le nombre d’espaces réservés à chiffre à droite détermine le nombre de chiffres dans l’exposant. Utilisez E- ou e- pour placer un signe moins en regard des exposants négatifs. Utilisez E+ ou e+ pour placer un signe moins en regard des exposants négatifs et un signe plus en regard des 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 (\) ou placez-le entre guillemets doubles ( » « ). |
(\\) |
Affichez le caractère suivant dans la chaîne de 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 identique au caractère suivant 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 caractères de mise en forme de date et d’heure (a, c, d, h, m, n, p, q, s, t, w, y, /, et :), les caractères de mise en forme numérique (#, 0, %, E, e, virgule et point) et les caractères de mise en forme de chaîne (@, &, <, >et !). |
| (« ABC ») | Affichez la chaîne entre guillemets doubles ( » « ). |
Formats de date/heure prédéfinis
Les formats de date/heure 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 format de date/heure personnalisé :
| Format | Description |
|---|---|
"General Date" |
Affiche une date et/ou une heure. Par exemple, 3/12/2008 11:07:31 AM. L’affichage de date est déterminé par la valeur de culture actuelle de votre application. |
"Long Date" ou "Medium Date" |
Affiche une date en fonction du format de date long de votre culture actuelle. Par exemple, mercredi 12 mars 2008. |
"Short Date" |
Affiche une date à l’aide du format de date court de votre culture actuelle. Par exemple, 3/12/2008. |
"Long Time" ou |
Affiche une heure à l’aide du format de longue durée de votre culture actuelle ; inclut généralement des heures, des minutes, des secondes. Par exemple, 11:07:31 AM. |
"Medium Time" |
Affiche une heure au format 12 heures. Par exemple, 11h07. |
"Short Time" |
Affiche une heure au format 24 heures. Par exemple, 11:07. |
Formats de date/heure personnalisés
Les caractères de format suivants peuvent être spécifiés dans l'format_string pour créer des formats de date/heure personnalisés :
| Personnage | Description |
|---|---|
(:) |
Séparateur de temps. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur de temps. Le séparateur de temps sépare les heures, les minutes et les secondes lorsque les valeurs de temps sont mises en forme. Le caractère réel utilisé comme séparateur de temps dans la sortie mise en forme est déterminé par vos paramètres système. |
(/) |
Séparateur de date. Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur de date. Le séparateur de date sépare le jour, le mois et l’année où les valeurs de date sont mises en forme. Le caractère réel utilisé comme séparateur de date dans la sortie mise en forme est déterminé par vos paramètres système. |
(\) |
Backslash. Affiche le caractère suivant en tant que caractère littéral. Il n’est donc pas interprété comme un caractère de mise en forme. |
(") |
Guillemets doubles. Le texte placé entre guillemets doubles s’affiche. Il n’est donc pas interprété comme des caractères de mise en forme. |
c |
Affichez la date sous forme de ddddd et affichez l’heure en tant que ttttt, dans cet ordre. Afficher uniquement les informations de date s’il n’existe aucune partie fractionnelle au numéro de série de date ; affiche uniquement les informations d’heure s’il n’y a aucune partie entière. |
d |
Affichez le jour sous la forme d’un nombre sans zéro non significatif (1 à 31). |
dd |
Affichez le jour sous forme de nombre avec un zéro non significatif (01-31). |
ddd |
Afficher le jour sous forme d’abréviation (Sun-Sat). Localisée. |
dddd |
Afficher le jour sous la forme d’un nom complet (Sunday-Saturday). Localisée. |
ddddd |
Affichez la date sous forme de date complète (y compris le jour, le mois et l’année), mise en forme en fonction du paramètre de format de date court de votre système. Le format de date courte par défaut est mm/dd/yyyy. |
dddddd |
Affichez un numéro de série de date comme date complète (y compris le jour, le mois et l’année) mise en forme en fonction du paramètre de date long reconnu par votre système. Le format de date long par défaut est dddd, mmmm d, yyyy. |
w |
Affichez le jour de la semaine sous la forme d’un nombre (1 pour dimanche à 7 pour samedi). |
ww |
Afficher la semaine de l’année sous la forme d’un nombre (1 à 54). |
m |
Affichez le mois sous la forme d’un nombre sans zéro non significatif (1 à 12). Si m suit immédiatement h ou hh, minute au lieu du mois s’affiche. |
mm |
Affichez le mois sous forme de nombre avec un zéro non significatif (01-12). Si mm suit immédiatement h ou hh, minute au lieu du mois s’affiche. |
mmm |
Afficher le mois sous forme d’abréviation (Jan-Dec). Localisée. |
mmmm |
Afficher le mois sous la forme d’un nom de mois complet (January-December). Localisée. |
q |
Affichez le trimestre de l’année sous la forme d’un nombre (1 à 4). |
y |
Affichez le jour de l’année sous la forme d’un nombre (1 à 366). |
yy |
Affichez l’année sous la forme d’un nombre à 2 chiffres (00-99). |
yyyy |
Affichez l’année sous la forme d’un nombre à 4 chiffres (100-9999). |
h |
Affichez l’heure sous la forme d’un nombre sans zéro non significatif (0-23). |
hh |
Affichez l’heure sous forme de nombre avec un zéro non significatif (00-23). |
n |
Affichez la minute sous la forme d’un nombre sans zéro non significatif (0-59). |
nn |
Affichez la minute sous forme de nombre avec un zéro non significatif (00-59). |
s |
Affichez la seconde sous la forme d’un nombre sans zéro non significatif (0-59). |
ss |
Affichez la seconde sous forme de nombre avec un zéro non significatif (00-59). |
ttttt |
Affichez une heure comme heure complète (y compris l’heure, la minute et la seconde), mise en forme à l’aide du séparateur d’heure défini par le format d’heure reconnu par votre système. Un zéro de début s’affiche si l’option zéro de début est sélectionnée et que l’heure est antérieure à 10 h 00 ou p.M. Le format d’heure par défaut est h:mm:ss. |
AM/PM |
Utilisez l’horloge de 12 heures et affichez un am majuscule avec n’importe quelle heure avant midi ; affiche un PM majuscule avec une heure comprise entre midi et 11 h 59. |
am/pm |
Utilisez l’horloge de 12 heures et affichez un am minuscule avec une heure avant midi ; affiche un PM minuscule avec une heure comprise entre midi et 11 h 59. |
A/P |
Utilisez l’horloge de 12 heures et affichez une majuscule A avec n’importe quelle heure avant midi ; affiche un P majuscule avec une heure comprise entre midi et 11:59 P. |
a/p |
Utilisez l’horloge de 12 heures et affichez une minuscule A avec n’importe quelle heure avant midi ; affiche un P minuscule avec une heure comprise entre midi et 11:59 P. |
AMPM |
Utilisez l’horloge de 12 heures et affichez le littéral de chaîne AM tel que défini par votre système avec n’importe quelle heure avant midi ; affichez le littéral de chaîne PM tel que défini par votre système avec n’importe quelle heure entre midi et 11:59 P.M. AMPM peut être en majuscules ou en minuscules, mais la casse de la chaîne affichée correspond à la chaîne telle que définie par vos paramètres système. Le format par défaut est AM/PM. Si votre système est défini sur une horloge de 24 heures, la chaîne est généralement définie sur une chaîne vide. |
La mise en forme de date/heure utilise les paramètres régionaux de l’utilisateur actuel pour mettre en forme la chaîne. Par exemple, considérez la date du 25 juin 2020. Lorsqu’elle est mise en forme à l’aide de la chaîne de format « 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 format de date/heure personnalisés
Les exemples suivants utilisent la date/heure jeudi 25 juin 2020, à 13h23:45. L’Allemagne (de-DE) utilise un système de 24 heures. 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" |
Année 2020 | Année 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 |