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.
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.
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.
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.
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».
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 -
|
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 .
|
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 (\).
Cependant, certains caractères ne peuvent pas être affichés en tant que caractères littéraux. Par exemple,
|
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 (")). |