Propriétés de cellule MDX - Contenu FORMAT_STRING

S’applique à : SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

La propriété de cellule FORMAT_STRING met en forme la propriété de cellule VALUE , en créant la valeur de la propriété de cellule FORMATTED_VALUE . La propriété de cellule FORMAT_STRING gère à la fois les valeurs brutes de chaîne et numériques, en appliquant une expression de format à la valeur pour retourner une valeur mise en forme pour la propriété de cellule FORMATTED_VALUE . Les tableaux suivants détaillent la syntaxe et les caractères de mise en forme utilisés pour gérer les valeurs de chaîne et numériques.

Valeurs de chaîne

Une expression de format pour les chaînes peut avoir une section ou deux sections séparées par un point-virgule (;).

Usage Résultat
Une section Le format s’applique à toutes les valeurs de chaîne.
Deux sections La première section s’applique aux données de chaîne, tandis que la deuxième section s’applique aux valeurs Null et aux chaînes de longueur nulle («  »).

Les caractères décrits dans le tableau suivant peuvent apparaître dans la chaîne de format pour les chaînes de caractères.

Caractère Descriptif
@ Représente un espace réservé de caractères qui affiche un caractère ou un espace. Si la chaîne a un caractère dans la position où le signe at (@) apparaît dans la chaîne de format, la chaîne mise en forme affiche le caractère. Sinon, la chaîne mise en forme affiche un espace dans cette position. Les espaces réservés sont remplis de droite à gauche, sauf s’il existe un point d’exclamation ( !) dans la chaîne de format.
& Représente un espace réservé de caractères qui affiche un caractère ou rien. Si la chaîne a un caractère dans la position où l’ampersand (&) apparaît, la chaîne mise en forme affiche le caractère. Sinon, la chaîne mise en forme n’affiche rien. Les espaces réservés sont remplis de droite à gauche, sauf s’il existe un point d’exclamation ( !) dans la chaîne de format.
< Force les minuscules. La chaîne mise en forme affiche tous les caractères au format minuscule.
> Force les majuscules. La chaîne mise en forme affiche tous les caractères au format majuscule.
! Force le remplissage gauche à droite des espaces réservés. (La valeur par défaut consiste à remplir les espaces réservés de droite à gauche.)

Valeurs numériques

Une expression de format définie par l’utilisateur pour les nombres peut avoir n’importe où d’un à quatre sections séparées par des points-virgules. Si l’argument de format contient l’un des formats numériques nommés, une seule section est autorisée.

Usage Résultat
Une section L’expression de mise en forme concerne toutes les valeurs.
Deux sections La première section concerne les valeurs positives et les zéros, la deuxième les valeurs négatives.
Trois sections La première section concerne les valeurs positives, la deuxième les valeurs négatives et la troisième les zéros.
Quatre sections La première section s’applique aux valeurs positives, à la seconde aux valeurs négatives, au troisième à zéro et aux quatrièmes à valeurs Null.

L’exemple suivant comporte deux sections. La première section définit le format des valeurs positives et des zéros, et la deuxième section définit le format des valeurs négatives.

"$#,##0;($#,##0)"

Si vous incluez des points-virgules avec rien entre eux, la section manquante s’imprime à 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;;\Z\e\r\o"

Le tableau suivant identifie les caractères qui peuvent apparaître dans la chaîne de format pour les formats numériques.

Caractère Descriptif
Aucun Affiche le nombre sans mise en forme.
0 Représente un espace réservé de chiffres qui affiche un chiffre ou un zéro (0).

Si le nombre a un chiffre dans la position où le zéro apparaît dans la chaîne de format, la valeur mise en forme affiche le chiffre. Sinon, la valeur mise en forme affiche un zéro dans cette position.

Si le nombre a moins de chiffres qu’il y a des zéros (du côté de la décimale) dans la chaîne de format, la valeur mise en forme 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 y a des zéros à droite du séparateur décimal dans l’expression de format, la valeur mise en forme arrondit le nombre à autant de décimales qu’il y a des 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, la valeur mise en forme affiche les chiffres supplémentaires sans modification.
# Représente un espace réservé à un chiffre qui affiche un chiffre ou rien.

Si l’expression a un chiffre dans la position où le signe numérique (#) apparaît dans la chaîne de format, la valeur mise en forme affiche le chiffre. Sinon, la valeur mise en forme n’affiche rien dans cette position.

L’espace réservé de signe numérique (#) fonctionne comme l’espace réservé zéro (0), 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.
. Représente un espace réservé décimal qui détermine le nombre de chiffres affichés à gauche et à droite du séparateur décimal.

Si l’expression de format contient uniquement des caractères de signe numérique (#) à gauche de la période (.), 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 (0) comme premier espace réservé numérique à 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 le système informatique.

Remarque : dans certains paramètres régionaux, une virgule est utilisée comme séparateur décimal.
% Représente un espace réservé en pourcentage. L’expression est multipliée par 100. Le caractère de pourcentage (%) est inséré dans la position où le pourcentage apparaît dans la chaîne de format.
, Représente un séparateur de milliers qui 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 placé entre 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 divisant le nombre par 1 000, arrondi selon les besoins ». 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 en tant que 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 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 le système informatique.

Remarque : Dans certains paramètres régionaux, une période est utilisée comme séparateur de milliers.
: Représente un séparateur de temps qui sépare les heures, les minutes et les secondes lorsque les valeurs de temps sont mises en forme.

Remarque : dans certains paramètres régionaux, d’autres caractères peuvent être utilisés comme séparateur de temps.

Le caractère réel utilisé comme séparateur de temps dans la sortie mise en forme est déterminé par les paramètres système sur l’ordinateur.
/ Représente un séparateur de date qui 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 les paramètres système sur l’ordinateur.

Remarque : dans certains paramètres régionaux, d’autres caractères peuvent être utilisés comme séparateur de date.
E- E+ e- e+ Représente le 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+, la valeur mise en forme s’affiche au format scientifique et E ou e est insérée entre le nombre et l’exposant du nombre. Le nombre d’espaces réservés de chiffres à droite détermine le nombre de chiffres dans l’exposant. Utilisez E- ou e- pour inclure un signe moins en regard des exposants négatifs. Utilisez E+ ou e+ pour inclure un signe moins en regard des exposants négatifs et un signe plus en regard des exposants positifs.
- + $ ( ) Affiche un caractère littéral.

Pour afficher un caractère autre que l’un de ceux répertoriés, placez une barre oblique inverse (\) avant le caractère ou placez le caractère entre guillemets doubles ( » « ).
\ Affiche 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, placez une barre oblique inverse (\) avant le caractère. La barre oblique inverse elle-même n’est pas affichée. L'utilisation d'une barre oblique inverse équivaut à mettre le caractère suivant entre des guillemets doubles. Pour afficher une barre oblique inverse, utilisez deux barres obliques inverses (\\). Les exemples de caractères qui ne peuvent pas être affichés en tant que caractères littéraux incluent les caractères suivants :



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 :

Caractères de mise en forme# numérique : 0, %, E, e, virgule et point

Caractères de mise en forme de chaîne,@&, &, <>et !
« ABC » Affiche la chaîne à l’intérieur des guillemets doubles ( » « ).

Pour inclure une chaîne au format à partir du code, utilisez Chr(34) pour placer le texte. (Le code de caractère d’un guillemet double est 34.)

Formats numériques nommés

Le tableau suivant identifie les noms de format numérique prédéfinis :

Nom de format Descriptif
General Number Affiche le nombre sans séparateur de milliers.
Currency Affiche le nombre avec un séparateur 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 du système.
Fixed Affiche au moins un chiffre à gauche et deux chiffres à droite du séparateur décimal.
Standard Affiche le nombre avec un séparateur de milliers, 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é à droite. Affiche toujours deux chiffres à droite du séparateur décimal.
Scientific Utilise la notation scientifique standard.
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é.

Valeurs de date

Le tableau suivant identifie les caractères qui peuvent apparaître dans la chaîne de format pour les formats de date/heure.

Caractère Descriptif
: Représente un séparateur de temps qui 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 les paramètres système de l’ordinateur.

Remarque : Dans certains paramètres régionaux, d’autres caractères peuvent être utilisés comme séparateur d’heure.
/ Représente un séparateur de date qui 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 les paramètres système de l’ordinateur.

Remarque : dans certains paramètres régionaux, d’autres caractères peuvent être utilisés pour représenter le séparateur de date
C Affiche la date comme ddddd et affiche l’heure sous forme de ttttt, dans cet ordre.

Affiche 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 Affiche le jour sous la forme d’un nombre sans zéro non significatif (1 à 31).
dd Affiche le jour sous forme de nombre avec un zéro non significatif (01-31).
Ddd Affiche le jour sous forme d’abréviation (Sun-Sat).
Delalande Affiche le jour sous la forme d’un nom complet (Sunday-Saturday).
ddddd Affiche 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.

Pour Microsoft Windows, le format de date courte par défaut est m/d/yy.
dddddd Affiche un numéro de série de date comme date complète (y compris le jour, le mois et l’année), mis en forme en fonction du paramètre de date long reconnu par le système informatique.

Pour Windows, le format de date long par défaut est mmmm dd, aaaa.
w Affiche le jour de la semaine sous forme de nombre (1 pour dimanche à 7 pour samedi).
ww Affiche la semaine de l’année sous forme de nombre (1 à 54).
m Affiche le mois sous la forme d’un nombre sans zéro non significatif (1 à 12).

Si m suit immédiatement h ou hh, la minute au lieu du mois est affichée.
mm Affiche le mois sous forme de nombre avec un zéro non significatif (01-12).

Si m suit immédiatement h ou hh, la minute au lieu du mois est affichée.
mmm Affiche le mois sous forme d’abréviation (Jan-Dec).
mmmm Affiche le mois sous la forme d’un nom de mois complet (January-December).
t Affiche le trimestre de l’année sous la forme d’un nombre (1 à 4).
y Affiche le jour de l’année sous forme de nombre (1 à 366).
yy Affiche l’année sous la forme d’un nombre à deux chiffres (00-99).
yyyy Affiche l’année sous la forme d’un nombre à quatre chiffres (100-9999).
h Affiche l’heure sous la forme d’un nombre sans zéros non significatifs (0-23).
hh Affiche l’heure sous la forme d’un nombre avec des zéros non significatifs (00-23).
n Affiche la minute sous forme de nombre sans zéros non significatifs (0-59).
nn Affiche la minute sous forme de nombre avec des zéros non significatifs (00-59).
s Affiche la seconde sous la forme d’un nombre sans zéros non significatifs (0-59).
ss Affiche la seconde sous forme de nombre avec des zéros non significatifs (00-59).
t t t t t Affiche 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 le système informatique.

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:00 dans le cycle A.M. ou P.M. . Par exemple, 09:59,

Pour Windows, le format d’heure par défaut est h :mm :ss.
AM/PM Affiche un am majuscule avec une heure comprise entre minuit et midi ; affiche un PM majuscule avec n’importe quelle heure de midi jusqu’à minuit.

Remarque : utilise l’horloge de 12 heures.
am/pm Affiche un am minuscule avec une heure comprise entre minuit et midi ; affiche une pm minuscule avec n’importe quelle heure de midi jusqu’à minuit.

Remarque : utilise l’horloge de 12 heures.
A/P Affiche un majuscule A avec n’importe quelle heure de minuit jusqu’à midi ; affiche un P majuscule avec n’importe quelle heure de midi jusqu’à minuit.

Remarque : utilise l’horloge de 12 heures.
a/p Affiche une minuscule avec une heure comprise entre minuit et midi ; affiche un p minuscule avec n’importe quelle heure de midi jusqu’à minuit.

Remarque : utilise l’horloge de 12 heures.
AMPM Affiche le littéral de chaîne AM tel que défini par le système informatique avec une heure comprise entre minuit et midi ; affiche le littéral de chaîne PM tel que défini par le système informatique avec n’importe quelle heure de midi jusqu’à minuit.

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 les paramètres système de l’ordinateur.

Pour Windows, le format par défaut est AM/PM.

Remarque : utilise l’horloge de 12 heures.

Formats de date nommés

Le tableau suivant identifie les noms de format de date et d’heure prédéfinis :

Nom du format Descriptif
General Date Affiche une date et/ou une heure. Pour les nombres réels, affiche une date et une heure, par exemple, 4/3/93 05:34 PM. S’il n’existe aucune partie fractionnaire, affiche uniquement une date, par exemple, 4/3/93. S’il n’existe aucune partie entière, affiche une heure uniquement, par exemple 05:34 PM. Le format de l’affichage de date est déterminé par vos paramètres système.
Long Date Affiche une date en fonction du format de date long de votre système.
Medium Date Affiche une date au format de date moyen approprié pour la version linguistique de l’application hôte.
Short Date Affiche une date au format de date court de votre système.
Long Time Affiche une heure à l’aide du format de temps long de votre système ; inclut les heures, les minutes et les secondes.
Medium Time Affiche une heure dans le format de 12 heures à l’aide d’heures et de minutes et de l’indicateur AM/PM.
Short Time Affiche une heure au format 24 heures, par exemple 17:45.

Voir aussi

LANGUAGE et FORMAT_STRING sur FORMATTED_VALUE
Utilisation des propriétés de cellule (MDX)
Création et utilisation de valeurs de propriété (MDX)
Notions de base des requêtes MDX (Analysis Services)

  • Last updated on