Formats numériques définis par l'utilisateur (fonction Format)

Mise à jour : novembre 2007

Le tableau suivant identifie les caractères que vous pouvez utiliser pour créer des formats de nombres définis par l'utilisateur. Ceux-ci peuvent être utilisés pour créer l'argument Style pour la fonction Format :

Caractère

Description

Aucun

Affiche le nombre sans mise en forme.

(0)

Espace réservé à un chiffre. Affiche un chiffre ou un zéro. Affiche un chiffre si l'expression a un chiffre dans la position où le zéro apparaît dans la chaîne de format ; sinon, affiche un zéro dans cette position.

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, 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, arrondit le nombre à autant de positions décimales qu'il y a de zéros. Si le nombre contient 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, affiche les chiffres supplémentaires sans modification.

(#)

Espace réservé à un chiffre. Affiche un chiffre ou rien. Affiche un chiffre si l'expression a un chiffre dans la position où le caractère # apparaît dans la chaîne de format ; sinon, n'affiche rien dans cette position.

Ce symbole fonctionne comme l'espace réservé au 0, sauf que les zéros non significatifs et à droite ne s'affichent pas si le nombre contient moins de chiffres qu'il n'y a de caractères # de part et d'autre du séparateur décimal dans l'expression de format.

(.)

Espace réservé aux décimales. L'espace réservé à la décimale 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 # à gauche de ce symbole, 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 comme premier espace réservé à un 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é à la décimale dans le résultat mis en forme dépend du format de nombre reconnu par votre système. Vous devriez donc utiliser le point comme espace réservé à la décimale dans vos mises en forme, même si vos paramètres régionaux utilisent la virgule à cette fin. La chaîne mise en forme apparaîtra dans le format correct pour les paramètres régionaux.

(%)

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

(,)

Séparateur de milliers. Le séparateur de milliers sépare les milliers des centaines dans un nombre qui possède 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 aux chiffres (0 ou #).

Un séparateur de milliers placé 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 dans la chaîne, signifie « mettre à l'échelle le nombre en le divisant par 1 000, en l'arrondissant si nécessaire ». Les nombres plus petits que 1 000 mais supérieurs ou égaux à 500 sont affichés comme 1, et les nombres plus petits que 500 sont affichés comme 0. Deux séparateurs de milliers adjacents dans cette position ont pour facteur d'échelle 1 million et un facteur complémentaire de 1 000 pour chaque séparateur supplémentaire.

Les séparateurs multiples dans n'importe quelle position autre que celle immédiatement à gauche du séparateur décimal ou la position la plus à droite dans la chaîne sont traités simplement comme le spécifie l'utilisation d'un séparateur de milliers. Dans certains paramètres régionaux, un point est utilisé comme séparateur de milliers. Le caractère réel utilisé comme séparateur de milliers dans le résultat mis en forme dépend du format de nombre reconnu par votre système. Vous devriez donc utiliser la virgule comme séparateur de milliers dans vos mises en forme, même si vos paramètres régionaux utilisent le point à cette fin. La chaîne mise en forme apparaîtra dans le format correct pour les paramètres régionaux.

Par exemple, considérez les trois chaînes de format suivantes :

  • "#,0.", qui utilise le séparateur des milliers pour mettre en forme le nombre 100 millions comme chaîne "100 000 000".

  • "#0,.", qui utilise un facteur d'échelle égal à mille pour mettre en forme le nombre 100 millions comme chaîne "100000".

  • "#,0,.", qui utilise le séparateur de milliers et un facteur d'échelle égal à mille pour mettre en forme le nombre 100 millions comme chaîne "100 000".

(:)

Séparateur d'heure. Dans certains paramètres régionaux, d'autres caractères peuvent être utilisés pour représenter le séparateur d'heure. Le séparateur d'heure sépare les heures, les minutes et les secondes lorsque les valeurs d'heure sont mises en forme. 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 de votre 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 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 de votre système.

(E-E+e-e+)

Format scientifique. Si l'expression de format contient au moins un espace réservé au 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 aux chiffres à gauche détermine le nombre de chiffres dans 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 aux chiffres à droite de ce symbole pour obtenir une mise en forme correcte.

-+$ ( )

Caractères littéraux. Ces caractères sont affichés exactement tels qu'ils sont tapés dans la chaîne de format. 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 (" ").

(\)

Affiche le caractère suivant dans 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 revient à placer le caractère suivant entre guillemets. Pour afficher une barre oblique inverse, utilisez deux barres obliques inverses (\\).

Parmi les caractères qui ne peuvent être affichés en tant que caractères littéraux, on peut citer 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înes (@, &, <, > et !).

("ABC")

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

Exemple

Le tableau suivant contient des exemples d'expressions de format pour des nombres (ces exemples supposent tous que votre système est défini avec les paramètres régionaux Anglais-États-Unis). La première colonne contient les chaînes de format pour l'argument Style de la fonction Format ; les autres colonnes contiennent le résultat obtenu si les données mises en forme ont la valeur donnée dans les en-têtes de colonnes.

Format (Style)

"5" mis en forme comme suit

"-5" mis en forme comme suit

"0.5" mis en forme comme suit

Zero-length string ("")

5

-5

0.5

0

5

-5

1

0.00

5.00

-5.00

0.50

#,##0

5

-5

1

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

$5

($5)

$1

$#,##0.00;($#,##0.00)

$5.00

($5.00)

$0.50

0%

500%

-500%

50%

0.00%

500.00%

-500.00%

50.00%

0.00E+00

5.00E+00

-5.00E+00

5.00E-01

0.00E-00

5.00E00

-5.00E00

5.00E-01

Configuration requise

Espace de noms :Microsoft.VisualBasic

**Module :**Strings

**Assembly :**bibliothèque Visual Basic Runtime (dans Microsoft.VisualBasic.dll)

Voir aussi

Référence

Liste des manipulations de chaînes

Liste des conversions

Formats différents pour valeurs numériques différentes (fonction Format)

Format, fonction

Formats numériques prédéfinis (fonction Format)

Formats de date/heure définis par l'utilisateur (fonction Format)