Texte DAX - Fonction FORMAT

La description

Convertit une valeur en texte selon le format spécifié.

Syntaxe

FORMAT (<value>, <format_string>)

Paramètres

N ° Sr. Paramètre et description
1

value

Une valeur ou une expression qui correspond à une valeur unique.

2

format_string

Une chaîne représentant un style de mise en forme.

  • Pour mettre en forme des nombres, vous pouvez utiliser des formats numériques prédéfinis ou créer des formats numériques définis par l'utilisateur.

Consultez les sections données à la fin de ce chapitre - Formats numériques prédéfinis et formats numériques personnalisés pour la fonction FORMAT.

  • Pour mettre en forme les dates et les heures, vous pouvez utiliser des formats de date / heure prédéfinis ou créer des formats de date / heure définis par l'utilisateur.

Reportez-vous au didacticiel - DAX dans cette bibliothèque de didacticiels pour plus de détails sur le formatage des dates et des heures.

Valeur de retour

Une chaîne contenant une valeur formatée comme définie par format_string.

Remarques

  • Si la valeur est BLANK (), la fonction FORMAT renvoie une chaîne vide.

  • Si format_string est BLANK (), la valeur est formatée avec un format "General Number" ou "General Date" (selon le type de données de valeur).

Exemple

Le tableau suivant montre les résultats de la fonction FORMAT avec la première valeur d'argument donnée dans la première ligne et format_string donnée dans la première colonne. Reportez-vous aux sections ci-dessous ce tableau pour comprendre les chaînes de format.

"5" "-5" "0,5" "0"
Chaîne de longueur nulle ("") 5 -5 0,5 0
0 5 -5 1 0
0,00 5,00 -5,00 0,50 0,00
#, ## 0 5 -5 1 0
$ #, ## 0; ($ #, ## 0) 5 $ (5 $) 1 $ 0 $
$ #, ## 0,00; ($ #, ## 0,00) 5,00 $ (5,00 $) 0,50 USD 0,00 USD
0% 500% -500% 50% 0%
0,00% 500,00% -500,00% 50,00% 0,00%
0,00E + 00 5,00E + 00 -5,00E + 00 5.00E-01 0,00E + 00
0,00E-00 5,00E00 -5,00E00 5.00E-1 0.00E00
"$ #, ## 0 ;; \ Z \ e \ r \ o" 5 $ -5 $ 1 $ Zéro

Formats numériques prédéfinis pour la fonction FORMAT

Le tableau suivant identifie les noms de format numériques prédéfinis qui peuvent être utilisés par nom pour l'argument de style de format de la fonction Format.

N ° Sr. Chaîne de format et description
1

"General Number"

Affiche le nombre sans mille séparateurs.

2

"Currency"

Affiche le nombre avec mille séparateurs, le cas échéant.

Affiche deux chiffres à droite du séparateur décimal.

La sortie est basée sur les paramètres régionaux du système.

3

"Fixed"

Affiche au moins un chiffre à gauche et deux chiffres à droite du séparateur décimal.

4

"Standard"

Affiche le nombre avec mille séparateurs, au moins un chiffre à gauche et deux chiffres à droite du séparateur décimal.

5

"Percent"

Affiche le nombre multiplié par 100 avec un signe de pourcentage (%) ajouté immédiatement à droite.

Affiche toujours deux chiffres à droite du séparateur décimal.

6

"Scientific"

Utilise la notation scientifique standard, fournissant deux chiffres significatifs.

sept

"Yes/No"

Affiche Non si le nombre est 0. Sinon, affiche Oui.

8

"True/False"

Affiche False si le nombre est 0. Sinon, affiche True.

9

"On/Off"

Affiche Off si le nombre est 0. Sinon, affiche On.

Formats numériques personnalisés pour la fonction FORMAT

Une expression de format définie par l'utilisateur pour les nombres peut avoir de une à trois sections séparées par des points-virgules.

Si l'argument format_string de la fonction Format contient l'un des formats numériques prédéfinis, une seule section est autorisée.

Le tableau suivant montre comment les sections sont appliquées lors du formatage.

N ° Sr. Résultat Nombre de sections et format
1

One section only

L'expression de format s'applique à toutes les valeurs.

2

Two sections

La première section s'applique aux valeurs positives et aux zéros.

Le second s'applique aux valeurs négatives.

3

Three sections

La première section s'applique aux valeurs positives.

La deuxième section s'applique aux valeurs négatives.

La troisième section s'applique aux zéros.

Si vous incluez des points-virgules sans rien entre eux, la section manquante est imprimée au format de la valeur positive.

Le tableau suivant identifie les caractères que vous pouvez utiliser pour créer des formats de nombre définis par l'utilisateur.

N ° Sr. Spécification et description du format
1

None

Affiche le nombre sans mise en forme.

2

0 (zero character)

Espace réservé aux chiffres. Affiche un chiffre ou un zéro.

Si l'expression a un chiffre à la position où le zéro apparaît dans la chaîne de format, affiche le chiffre. Sinon, affiche un zéro dans cette position.

Si le nombre comporte moins de chiffres qu'il n'y a de zéros (de chaque côté de la décimale) dans l'expression de format, affiche les zéros de début ou de fin.

Si le nombre a plus de chiffres à droite du séparateur décimal qu'il n'y a de zéros à droite du séparateur décimal dans l'expression de format, arrondit le nombre à autant de décimales qu'il y a de zéros.

Si le nombre a plus de chiffres à gauche du séparateur décimal qu'il n'y a de zéros à gauche du séparateur décimal dans l'expression de format, affiche les chiffres supplémentaires sans modification.

  • Si l'expression a un chiffre à la position où le caractère # apparaît dans la chaîne de format, affiche le chiffre.

  • Sinon, n'affiche 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 comporte moins de chiffres qu'il n'y a de caractères # de chaque côté du séparateur décimal dans l'expression de format.

3

. (dot character)

Espace réservé 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 ne contient que # caractères à 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 zéro comme premier espace réservé de chiffre à gauche du séparateur décimal.

Dans certains paramètres régionaux, une virgule est utilisée comme séparateur décimal. Le caractère réel utilisé comme espace réservé décimal dans la sortie formatée dépend du format numérique reconnu par votre système. Par conséquent, vous devez utiliser le point comme espace réservé décimal dans vos formats, même si vous êtes dans un environnement local qui utilise une virgule comme espace réservé décimal. La chaîne formatée apparaîtra dans le format correct pour les paramètres régionaux.

4

%

Pourcentage d'espace réservé. Multiplie l'expression par 100. Le caractère de pourcentage (%) est inséré à l'endroit où il apparaît dans la chaîne de format.

5

, (comma character)

Mille séparateur. Le séparateur de milliers sépare les milliers des centaines dans un nombre qui a quatre places ou plus à gauche du séparateur décimal.

L'utilisation standard du séparateur des milliers est spécifiée si le format contient un séparateur des milliers entouré d'espaces réservés de chiffres (0 ou #). Un séparateur de milliers immédiatement à gauche du séparateur décimal (qu'une décimale soit spécifiée ou non) ou en tant que caractère le plus à droite de la chaîne signifie «mettre à l'échelle le nombre en le divisant par 1 000, en arrondissant si nécessaire».

  • Les nombres inférieurs à 1 000 mais supérieurs ou égaux à 500 sont affichés sous la forme 1, et les nombres inférieurs à 500 sont affichés sous la forme 0.

  • Deux mille séparateurs adjacents dans cette position sont mis à l'échelle par un facteur de 1 million et un facteur supplémentaire de 1 000 pour chaque séparateur supplémentaire.

  • Les séparateurs multiples dans n'importe quelle position autre qu'immédiatement à gauche du séparateur décimal ou la position la plus à droite dans la chaîne sont traités simplement comme spécifiant l'utilisation d'un séparateur de mille.

Dans certains paramètres régionaux, un point est utilisé comme séparateur de milliers. Le caractère réel utilisé comme séparateur des milliers dans la sortie formatée dépend du format numérique reconnu par votre système. Ainsi, vous devez utiliser la virgule comme séparateur des milliers dans vos formats, même si vous vous trouvez dans un environnement local qui utilise un point comme séparateur de milliers. La chaîne formatée apparaîtra dans le format correct pour les paramètres régionaux.

Exemples -

  • "#, 0." Utilise le séparateur des milliers pour mettre en forme le nombre 100 millions en tant que chaîne "100 000 000".

  • «# 0,» Utilise une mise à l'échelle par un facteur de mille pour mettre en forme le nombre 100 millions comme la chaîne «100000».

  • "#, 0 ,." Utilise le séparateur des milliers et la mise à l'échelle par mille pour formater le nombre 100 millions en tant que chaîne «100 000».

6

: (colon character)

Séparateur de temps. Le séparateur d'heure sépare les heures, les minutes et les secondes lorsque les valeurs d'heure sont formatées.

Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés pour représenter le séparateur d'heure. Le caractère réel utilisé comme séparateur d'heure dans la sortie formatée est déterminé par les paramètres de votre système.

sept

/ (forward slash character)

Séparateur de date. Le séparateur de date sépare le jour, le mois et l'année de mise en forme des valeurs 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 caractère réel utilisé comme séparateur de date dans la sortie formatée est déterminé par les paramètres de votre système.

8

E- , E+ , e- , e+

Scientific format.

Si l'expression de format contient au moins un espace réservé à un chiffre (0 ou #) à gauche 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 de chiffres à gauche détermine le nombre de chiffres de l'exposant.
  • Utilisez E- ou e- pour placer un signe moins à côté des exposants négatifs.
  • Utilisez E + ou e + pour placer un signe moins à côté des exposants négatifs et un signe plus à côté des exposants positifs.
  • Vous devez également inclure des espaces réservés de chiffres à droite de ce symbole pour obtenir une mise en forme correcte.
9

-+$()

Caractères littéraux. Ces caractères sont affichés exactement tels qu'ils ont été saisis dans la chaîne de format.

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 ("").

dix

\ (backward slash character)

Affiche le caractère suivant dans la chaîne de format. Pour afficher un caractère qui a une signification particulière 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 revient à placer le caractère suivant entre guillemets doubles.
  • Pour afficher une barre oblique inverse, utilisez deux barres obliques inverses.

Cependant, certains caractères ne peuvent pas être affichés en tant que caractères littéraux. Par exemple,

  • Les caractères de formatage de la date et de l'heure (a, c, d, h, m, n, p, q, s, t, w, y, / et :)
  • Les caractères de formatage numérique (#, 0,%, E, e, virgule et point)
  • Les caractères de formatage de chaîne (@, &, <,> et!)
11

"ABC"

Affiche la chaîne entre guillemets doubles (""). Pour inclure une chaîne dans l'argument de style à partir du code, vous devez utiliser Chr (34) pour entourer le texte (34 est le code de caractère pour un guillemet (")).