Contenu de FORMAT_STRING (MDX)

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, qui traite les valeurs brutes de types chaîne et numérique, applique une expression de format à la valeur afin de 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 traiter les valeurs de type chaîne et numérique.

Valeurs de type chaîne

Une expression de format pour une chaîne peut posséder une section, ou deux sections séparées par un point-virgule (;).

Utilisation	Résultat
Une section	La mise en forme s'applique à toutes les valeurs de type chaîne.
Deux sections	La première section s'applique aux données de type chaîne tandis que la seconde s'applique aux valeurs NULL et aux chaînes de longueur zéro ("").

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

Caractère	Description
@	Représente un espace réservé de caractère qui affiche un caractère ou un espace. Si la chaîne possède un caractère à l'endroit où figure le signe « a » commercial (@) dans la chaîne de format, elle affiche ce caractère. Sinon, un espace est affiché à la place. Les espaces réservés se remplissent de la droite vers la gauche sauf si un point d'exclamation (!) est présent dans la chaîne de format.
&	Représente un espace réservé de caractère qui affiche un caractère ou rien. Si la chaîne possède un caractère à l'endroit où figure le signe « et » commercial (&), la chaîne mise en forme affiche ce caractère. Sinon, rien n'est affiché. Les espaces réservés se remplissent de la droite vers la gauche sauf si un point d'exclamation (!) est présent dans la chaîne de format.
<	Impose les caractères minuscules. La chaîne mise en forme affiche tous les caractères en minuscules.
>	Impose les caractères majuscules. La chaîne mise en forme affiche tous les caractères en majuscules.
!	Impose le remplissage des espaces réservés de la gauche vers la droite. (Par défaut, ils se remplissent de la droite vers la gauche.)

Valeurs numériques

Pour les nombres, une expression de format définie par l'utilisateur peut posséder de une à 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.

Utilisation	Résultat
Une section	L'expression de format s'applique à toutes les valeurs.
Deux sections	La première section s'applique aux valeurs positives et aux zéros, et la seconde aux valeurs négatives.
Trois sections	La première section s'applique aux valeurs positives, la deuxième aux valeurs négatives et la troisième aux zéros.
Quatre sections	La première section s'applique aux valeurs positives, la deuxième aux valeurs négatives, la troisième aux zéros et la quatrième aux valeurs NULL.

L'exemple suivant possède deux sections : la première définit le format des valeurs positives et des zéros, tandis que la seconde définit le format des valeurs négatives.

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

Si vous incluez des points-virgules sans rien entre, la section manquante utilise le format de la valeur positive. Par exemple, le format suivant affiche les valeurs positives et négatives d'après le format défini dans la première section et affiche « Zéro » si la valeur est zéro :

"$#,##0;;\Z\e\r\o"

Le tableau suivant décrit les caractères qui peuvent figurer dans la chaîne de format des nombres.

Caractère

Description

Aucun

Affiche le nombre sans mise en forme.

0

Représente un espace réservé de chiffre qui affiche un chiffre ou zéro (0).

Si le nombre possède un chiffre là où figure le zéro dans la chaîne de format, la valeur mise en forme affiche ce chiffre. Sinon, zéro est affiché à la place.

Si le nombre contient moins de chiffres que de zéros (de part et d'autre du séparateur décimal) dans l'expression de format, la valeur mise en forme affiche des zéros non significatifs ou à droite.

Si le nombre contient davantage 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, la valeur mise en forme arrondit le nombre à autant de positions décimales qu'il y a de zéros.

Si le nombre comporte davantage 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, la valeur mise en forme affiche les chiffres supplémentaires sans modification.

#

Représente un espace réservé de chiffre qui affiche un chiffre ou rien.

Si l'expression possède un chiffre là où figure le signe dièse (#) dans la chaîne de format, la valeur mise en forme affiche ce chiffre. Sinon, rien n'est affiché à la place.

Le signe dièse (#) fonctionne comme l'espace réservé zéro (0), à la différence qu'aucun zéro non significatif de début et de fin n'est affiché si le nombre possède un nombre de chiffres inférieur ou égal au nombre de caractères # d'un côté ou de l'autre du séparateur décimal dans l'expression de format.

.

Représente un espace réservé de décimale qui détermine le nombre de chiffres affichés à gauche et à droite du séparateur décimal.

Si l'expression de format ne contient que des caractères dièse (#) à gauche du point (.), les nombres inférieurs à 1 commencent par un séparateur décimal. Pour afficher un zéro non significatif avec des nombres fractionnaires, utilisez zéro (0) comme premier espace réservé de chiffre à gauche du séparateur décimal.

Le caractère effectivement utilisé comme séparateur décimal dans le résultat mis en forme dépend du format numérique reconnu par votre système.

Remarque :

Dans certains paramètres régionaux, une virgule est utilisée comme séparateur décimal.

%

Représente un espace réservé de pourcentage. L'expression est multipliée par 100. Le caractère de pourcentage (%) est inséré à l'endroit où il apparaît dans la chaîne de format.

,

Représente un séparateur de milliers qui sépare les milliers des centaines dans un nombre possédant quatre chiffres 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é par des espaces réservés de chiffres (0 ou #).

La présence de deux séparateurs des milliers contigus, ou d'un séparateur des milliers juste à gauche du séparateur décimal (qu'une décimale soit ou non spécifiée), signifie « changer l'échelle du nombre en le divisant par 1 000, en l'arrondissant le cas échéant ». Par exemple, vous pouvez utiliser la chaîne de format « ##0,, » pour représenter 100 millions par 100. Les nombres inférieurs à 1 million sont affichés sous la forme 0. Deux séparateurs de milliers contigus situés ailleurs que juste à gauche du séparateur décimal sont traités comme spécifiant l'utilisation d'un séparateur des milliers.

Le caractère effectivement utilisé comme séparateur des milliers dans le résultat mis en forme dépend du format numérique reconnu par votre système.

Remarque :

Dans certains paramètres régionaux, un point est utilisé comme séparateur de milliers.

:

Représente un séparateur horaire qui sépare les heures, les minutes et les secondes lors de la mise en forme de valeurs horaires.

Remarque :

Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés comme séparateurs d'heure.

Le caractère réel utilisé comme séparateur d'heure dans le résultat mis en forme est déterminé par les paramètres système de votre ordinateur.

/

Représente un séparateur de date qui sépare le jour, le mois et l'année lorsque les valeurs de date sont mises en forme.

Le caractère réel utilisé comme séparateur de date dans le résultat mis en forme est déterminé par les paramètres système de votre ordinateur.

Remarque :

Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés comme séparateurs de date.

E- E+ e- e+

Représente le format scientifique.

Si l'expression de format contient au moins un espace réservé de chiffre (0 ou #) à droite de E-, E+, e- ou e+, la valeur mise en forme affiche le nombre dans le format scientifique et E ou e est inséré entre le nombre et son exposant. Le nombre d'espaces réservés à des chiffres à droite détermine le nombre de chiffres dans l'exposant. Utilisez E- ou e- pour insérer un signe moins à côté des exposants négatifs. Utilisez E+ ou e+ pour insérer un signe moins à côté des exposants négatifs et un signe plus à côté des exposants positifs.

- + $ ( )

Affiche un caractère littéral.

Pour afficher un caractère autre que ceux répertoriés, faites-le précéder d'une barre oblique inverse (\) ou placez-le entre guillemets doubles (" ").

\

Affiche le prochain caractère de la chaîne de format.

Pour afficher un caractère ayant 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 équivaut à mettre le caractère suivant entre des guillemets doubles. Pour afficher une barre oblique inverse, utilisez deux barres obliques inverses (\\). Exemples de caractères ne pouvant pas être affichés comme caractères littéraux :

• 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) ;
• les caractères de mise en forme de chaîne (@, &, <, > et !).

"ABC"

Affiche la chaîne placée entre les guillemets doubles (" ").

Pour codifier l'insertion d'une chaîne dans le format, placez le texte entre Chr(34). (Le code de caractère pour un guillemet double est 34.)

Valeurs de date

Le tableau suivant décrit les caractères qui peuvent figurer dans les chaînes de format de date et d'heure.

Caractère

Description

:

Représente un séparateur horaire qui sépare les heures, les minutes et les secondes lors de la mise en forme de valeurs horaires.

Le caractère réel utilisé comme séparateur d'heure dans le résultat mis en forme est déterminé par les paramètres système de votre ordinateur.

Remarque :

Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés comme séparateurs d'heure.

/

Représente un séparateur de date qui sépare le jour, le mois et l'année lorsque les valeurs de date sont mises en forme.

Le caractère réel utilisé comme séparateur de date dans le résultat mis en forme est déterminé par les paramètres système de votre 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, dans l'ordre, la date sous la forme ddddd et l'heure sous la forme ttttt.

Affiche uniquement les informations de date si le numéro de série de la date ne comporte pas de partie fractionnaire. Affiche uniquement les informations d'heure s'il n'y a pas de partie entière.

d

Affiche le jour sous la forme d'un nombre sans zéro non significatif (de 1 à 31).

dd

Affiche le jour sous la forme d'un nombre comprenant au besoin un zéro non significatif (de 01 à 31).

ddd

Affiche le jour sous forme abrégée (dim–sam).

dddd

Affiche le jour sous forme non abrégée (dimanche–samedi).

ddddd

Affiche la date complète (jour, mois et année), d'après le format de date abrégée défini sur votre système.

Pour Microsoft Windows, le format de date abrégée par défaut est m/d/yy.

dddddd

Affiche un numéro de série de date complète (jour, mois et année), d'après le format de date complète défini sur votre système.

Pour Windows, le format de date complète par défaut est mmmm dd, yyyy.

w

Affiche le jour de la semaine sous la forme d'un nombre (de 1 pour dimanche à 7 pour samedi).

ww

Affiche la semaine de l'année sous la forme d'un nombre (de 1 à 54).

m

Affiche le mois sous la forme d'un nombre sans zéro non significatif (de 1 à 12).

Si m suit immédiatement h ou hh, les minutes sont affichées au lieu du mois.

mm

Affiche le mois sous la forme d'un nombre comprenant au besoin un zéro non significatif (de 01 à 12).

Si m suit immédiatement h ou hh, les minutes sont affichées au lieu du mois.

mmm

Affiche le mois sous forme abrégée (jan–déc).

mmmm

Affiche le mois sous forme non abrégée (janvier–décembre).

q

Affiche le trimestre de l'année sous la forme d'un nombre (de 1 à 4).

y

Affiche le jour de l'année sous la forme d'un nombre (de 1 à 366).

yy

Affiche l'année sous la forme d'un nombre à deux chiffres (de 00 à 99).

yyyy

Affiche l'année sous la forme d'un nombre à quatre chiffres (de 100 à 9999).

H

Affiche l'heure sous la forme d'un nombre sans zéro non significatif (de 0 à 23).

hh

Affiche l'heure sous la forme d'un nombre comprenant au besoin des zéros non significatifs (de 00 à 23).

n

Affiche les minutes sous la forme d'un nombre sans zéro non significatif (de 0 à 59).

nn

Affiche les minutes sous la forme d'un nombre comprenant au besoin des zéros non significatifs (de 00 à 59).

s

Affiche les secondes sous la forme d'un nombre sans zéro non significatif (de 0 à 59).

ss

Affiche les secondes sous la forme d'un nombre comprenant au besoin des zéros non significatifs (de 00 à 59).

t t t t t

Affiche l'heure complète (heures, minutes et secondes), dans une mise en forme qui reprend le séparateur horaire défini dans les paramètres horaires de votre système.

Un zéro non significatif apparaît si l'option du zéro non significatif est sélectionnée et si 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 AM en majuscules avec toute heure comprise entre minuit et midi et PM en majuscules avec toute heure comprise entre midi et minuit.

Remarque :

Utilise le format d'horloge sur 12 heures.

am/pm

Affiche am en minuscules avec toute heure comprise entre minuit et midi, et pm en minuscules avec toute heure comprise entre midi et minuit.

Remarque :

Utilise le format d'horloge sur 12 heures.

A/P

Affiche un A majuscule avec toute heure comprise entre minuit et midi et P majuscule avec toute heure comprise entre midi et minuit.

Remarque :

Utilise le format d'horloge sur 12 heures.

a/p

Affiche un a minuscule avec toute heure comprise entre minuit et midi, et p minuscule avec toute heure comprise entre midi et minuit.

Remarque :

Utilise le format d'horloge sur 12 heures.

AMPM

Affiche la constante de chaîne AM telle qu'elle est définie par votre système avec toute heure comprise entre minuit et midi, et la constante de chaîne PM telle qu'elle est définie par votre système avec toute heure comprise entre midi et minuit.

Remarque :

Utilise le format d'horloge sur 12 heures.

AMPM peut être exprimé en majuscules ou en minuscules, mais la casse de la chaîne affichée correspond à la définition de la chaîne dans les paramètres de votre système.

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

Voir aussi

Concepts

Utilisation des propriétés de cellule (MDX)

Aide et Informations

Assistance sur SQL Server 2005