Si la propriété Format ne commence pas par un signe de pourcentage (%) et ne contient aucun symbole (@), la mise en forme sera réalisée en fonction des codes de mise en forme des nombres. La mise en forme s'attend à ce que la Chaîne soit une valeur en virgule flottante. Les spécificateurs de format suivants sont pris en charge dans la propriété Format :
|
Spécificateur |
Description |
|---|---|
|
espace réservé pour le caractère « 0 » |
Si la valeur mise en forme comporte un chiffre à l'emplacement où « 0 » apparaît dans la chaîne de format, ce chiffre est copié dans la chaîne résultante. Dans le cas contraire, un « 0 » est stocké dans cette position dans la chaîne résultante. |
|
espace réservé pour chiffre # |
Si la valeur mise en forme comporte un chiffre dans la position où le « # » apparaît dans la chaîne de format, le chiffre est copié vers la chaîne résultante. Sinon, rien n'est stocké à cette position dans la chaîne de sortie. |
|
. Virgule |
La première '.' caractère dans la chaîne de format détermine l'emplacement du séparateur décimal dans la valeur formatée ; tout '.' supplémentaire les caractères sont ignorés. |
|
Séparateur des milliers (,) |
Si la chaîne de format contient un ou plusieurs caractères « , », la sortie contiendra des séparateurs de milliers entre chaque groupe de trois chiffres à gauche du séparateur décimal. La position et le nombre de caractères « , » dans la chaîne de format n'affectent pas la sortie, si ce n'est pour indiquer l'utilisation de séparateurs de milliers. |
|
Notation scientifique E+ |
Si une des chaînes « E », « E+ », « E- », « e », « e+ » ou « e- » est présente dans la chaîne de format, le nombre est mis en forme en utilisant la notation scientifique. Un groupe de quatre caractères « 0 » au maximum peut immédiatement suivre le « E+ », « E- », « e+ » ou « e- » afin de déterminer le nombre maximum de chiffres de l'exposant. Les formats « E+ » et « e+ » produisent une sortie contenant un signe plus pour les exposants positifs et un signe moins pour les exposants négatifs. Les formats « E+ » et « e+ » produisent une sortie contenant un signe moins pour les exposants négatifs. |
|
'xx'/"xx" |
Les caractères entre guillemets simples ou doubles sont sortis tels quels et n'affectent pas la mise en forme. |
|
; |
Ce caractère sépare les sections réservées aux nombres positifs, négatifs et aux zéros dans la chaîne de format. |
Les emplacements du « 0 » situé le plus à gauche avant le séparateur décimal et du « 0 » situé le plus à droite après le séparateur décimal dans la chaîne de format déterminent la plage des chiffres qui sont toujours présents dans la chaîne résultante.
Le nombre mis en forme est toujours arrondi au nombre de décimales indiqué par les espaces réservés pour caractères (« 0 » ou « # ») à droite du séparateur décimal. Si la chaîne de format ne contient aucun séparateur décimal, la valeur mise en forme est arrondie au nombre entier le plus proche.
Si le nombre mis en forme comporte davantage de chiffres à gauche du séparateur décimal que d'espaces réservés pour caractères à gauche du caractère « , » dans la chaîne de format, les caractères supplémentaires sont renvoyés avant le premier espace réservé pour caractère.
Pour spécifier différents formats pour les valeurs positives, négatives et nulles, la chaîne de format peut contenir de une à trois sections séparées par des points-virgules :
- Une section : la chaîne de format s'applique à toutes les valeurs.
- Deux sections : la première section s'applique aux valeurs positives et égales à zéro, et la seconde section s'applique aux valeurs négatives.
- Trois sections : la première section s'applique aux valeurs positives, la seconde aux valeurs négatives, et la troisième aux valeurs égales à zéro.
Si la section dédiée aux valeurs négatives ou la section dédiée aux valeurs égales à zéro sont vides, cad. qu'il n'y a rien entre les points-virgules qui délimitent la section, la section dédiée aux valeurs positives est utilisée à la place.
Si la section dédiée aux valeurs positives est vide, ou si la chaîne de format toute entière est vide, la valeur est mise en forme à l'aide d'une mise en forme à virgule flottante générale comportant 15 chiffres significatifs. La mise en forme générale à virgule flottante est également utilisée si la valeur comporte moins de 18 chiffres à gauche du séparateur décimal et que la chaîne de format ne spécifie pas de notation scientifique.
Le tableau suivant contient des exemples de valeurs saisies dans les propriétés Format et String (chaîne) :
|
Propriété Format |
Propriété String : 1234 |
Propriété String : -1234 |
Propriété String : 0,5 |
Propriété String : 0 |
|---|---|---|---|---|
|
0 |
1234 |
-1234 |
0,5 |
0 |
|
0,00 |
1234.00 |
-1234,00 |
0,50 |
0,00 |
|
#.## |
1234 |
-1234 |
.5 |
|
|
#,##0.00 |
1 234.00 |
-1 234.00 |
0,50 |
0,00 |
|
#,##0.00;(#,##0.00) |
1 234.00 |
(1 234,00) |
0,50 |
0,00 |
|
#,##0.00;;Zero |
1 234.00 |
-1 234.00 |
0,50 |
Zero |
|
0,000E + 00 |
0,000E + 03 |
-1.234E+03 |
5.000E-01 |
0,000E + 00 |
|
#.###E-0 |
1.234E3 |
-1.234E3 |
5E-1 |
0E0 |