Chaînes de format numériques personnalisées

#

Espace réservé de chiffre

Si la valeur mise en forme possède un chiffre à l'emplacement où « # » apparaît dans la chaîne de format, ce chiffre est copié dans la chaîne résultante. Sinon, rien n'est stocké à cet emplacement dans la chaîne résultante.

Remarquez que ce spécificateur n'affiche jamais le caractère « 0 » s'il ne s'agit pas d'un chiffre significatif, même si « 0 » est le seul chiffre de la chaîne. Il affiche le caractère « 0 » s'il s'agit d'un chiffre significatif dans le nombre qui apparaît.

La chaîne de format « ## » provoque l'arrondissement de la valeur au chiffre le plus proche précédant la virgule ; l'arrondissement à une valeur différente de zéro est toujours utilisé. Par exemple, la mise en forme de 34,5 avec « ## » produit la valeur 35.

L'exemple suivant affiche plusieurs valeurs mises en forme à l'aide de chaînes de format personnalisées qui incluent des espaces réservés aux chiffres.

      Dim value As Double

      value = 1.2
      Console.WriteLine(value.ToString("#.##", CultureInfo.InvariantCulture))
      ' Displays 1.2

      value = 123
      Console.WriteLine(value.ToString("#####"))
      ' Displays 123

      value = 123456
      Console.WriteLine(value.ToString("[##-##-##]"))      
       ' Displays [12-34-56]

      value = 1234567890
      Console.WriteLine(value.ToString("#"))
      ' Displays 1234567890
      Console.WriteLine(value.ToString("(###) ###-####"))
      ' Displays (123) 456-7890

      double value;

      value = 1.2;
      Console.WriteLine(value.ToString("#.##", CultureInfo.InvariantCulture));
      // Displays 1.2

      value = 123;
      Console.WriteLine(value.ToString("#####"));
      // Displays 123

      value = 123456;
      Console.WriteLine(value.ToString("[##-##-##]"));      
       // Displays [12-34-56]

      value = 1234567890;
      Console.WriteLine(value.ToString("#"));
      // Displays 1234567890
      Console.WriteLine(value.ToString("(###) ###-####"));
      // Displays (123) 456-7890

,

Séparateur des milliers et mise à l'échelle des nombres

Le caractère « , » sert aussi bien de spécificateur de séparateur de milliers que de spécificateur de mise à l'échelle des nombres.

Spécificateur de séparateur de milliers : si un ou plusieurs caractères « , » sont spécifiés entre deux espaces réservés aux chiffres (0 ou #) qui mettent en forme les chiffres intégraux d'un nombre, un caractère de séparation des groupes est inséré entre chaque groupe de nombres dans la partie intégrale de la sortie.

Les propriétés NumberGroupSeparator et NumberGroupSizes de l'objet NumberFormatInfo en cours déterminent le caractère utilisé comme séparateur de groupes de nombres et la taille de chaque groupe de nombres. Par exemple, si la chaîne « #,# » et la culture indifférente sont utilisées pour mettre en forme le nombre 1000, la sortie est « 1,000 ».

Spécificateur de mise à l'échelle des nombres : si un ou plusieurs caractères « , » sont spécifiés immédiatement à gauche de la virgule décimale explicite ou implicite, le nombre à mettre en forme est divisé par 1000 chaque fois qu'un spécificateur de mise à l'échelle des nombres se présente. Par exemple, si la chaîne « 0,, » est utilisée pour mettre en forme le nombre 100 millions, la sortie est « 100 ».

Vous pouvez utiliser des spécificateurs de séparateur de milliers et de mise à l'échelle des nombres dans la même chaîne de format. Par exemple, si la chaîne « #,0,, » et la culture indifférente sont utilisées pour mettre en forme le nombre 1 milliard, la sortie est « 1,000 ».

L'exemple suivant illustre l'utilisation de la virgule comme séparateur de milliers.

Dim value As Double = 1234567890
Console.WriteLine(value.ToString("#,#", CultureInfo.InvariantCulture))
' Displays 1,234,567,890      
Console.WriteLine(value.ToString("#,##0,,", CultureInfo.InvariantCulture))
' Displays 1,235        

double value = 1234567890;
Console.WriteLine(value.ToString("#,#", CultureInfo.InvariantCulture));
// Displays 1,234,567,890      
Console.WriteLine(value.ToString("#,##0,,", CultureInfo.InvariantCulture));
// Displays 1,235       

L'exemple suivant illustre l'utilisation de la virgule comme spécificateur pour la mise à l'échelle des nombres.

      Dim value As Double = 1234567890
      Console.WriteLine(value.ToString("#,,", CultureInfo.InvariantCulture))    
      ' Displays 1235   
      Console.WriteLine(value.ToString("#,,,", CultureInfo.InvariantCulture))
       ' Displays 1  
      Console.WriteLine(value.ToString("#,##0,,", CultureInfo.InvariantCulture))       
       ' Displays 1,235

      double value = 1234567890;
      Console.WriteLine(value.ToString("#,,", CultureInfo.InvariantCulture));   
      // Displays 1235   
      Console.WriteLine(value.ToString("#,,,", CultureInfo.InvariantCulture));
       // Displays 1  
      Console.WriteLine(value.ToString("#,##0,,", CultureInfo.InvariantCulture));       
       // Displays 1,235

‰

Espace réservé « pour mille »

La présence d'un caractère « ‰ » (\u2030) dans une chaîne de format entraîne la multiplication d'un nombre par 1 000 avant sa mise en forme. Le symbole « pour mille » approprié est inséré dans la chaîne retournée, à l'emplacement où le symbole « ‰ » apparaît dans la chaîne de format. Le caractère « pour mille » utilisé est défini par la propriété NumberFormatInfo.PerMilleSymbol de l'objet qui fournit les informations de mise en forme spécifique à la culture.

L'exemple suivant définit une chaîne de format personnalisée qui inclut l'espace réservé « pour mille ».

Dim value As Double = .00354
Dim perMilleFmt As String = "#0.## " & ChrW(&h2030)
Console.WriteLine(value.ToString(perMilleFmt, CultureInfo.InvariantCulture))
' Displays 3.54 ‰      

double value = .00354;
string perMilleFmt = "#0.## " + '\u2030';
Console.WriteLine(value.ToString(perMilleFmt, CultureInfo.InvariantCulture));
// Displays 3.54‰      

\

Caractère d'échappement

En C# et C++, la barre oblique inverse entraîne l'interprétation du caractère suivant de la chaîne de format comme une séquence d'échappement. Elle est utilisée dans les séquences de mise en forme traditionnelles, telles que « \n » (nouvelle ligne).

Dans certains langages, le caractère d'échappement proprement dit doit être précédé d'un caractère d'échappement s'il est utilisé comme caractère littéral. Sinon, le compilateur interprète le caractère comme une séquence d'échappement. Utilisez la chaîne « \\ » pour afficher « \ ».

Remarquez que ce caractère d'échappement n'est pas pris en charge dans Visual Basic. Cependant, ControlChars fournit les mêmes fonctionnalités.

;

Séparateur de section

Le caractère « ; » est utilisé pour séparer les sections pour les nombres positifs, négatifs et les zéros dans la chaîne de format. Si la chaîne de format personnalisée comprend deux sections, la section la plus à gauche définit la mise en forme des nombres positifs et nuls, alors que la section la plus à droite définit la mise en forme des nombres négatifs. Si elle comprend trois sections, la section la plus à gauche, la section centrale et la section la plus à droite définissent respectivement la mise en forme des nombres positifs, des nombres négatifs et des nombres nuls.

L'exemple suivant utilise le spécificateur de format pour le séparateur de section afin de mettre en forme différemment les nombres positifs, négatifs et nuls.

Dim posValue As Double = 1234
Dim negValue As Double = -1234
Dim fmt As String = "##;(##)"
Console.WriteLine(posValue.ToString(fmt))    ' Displays 1234
Console.WriteLine(negValue.ToString(fmt))    ' Displays (1234)

double posValue = 1234;
double negValue = -1234;
string fmt = "##;(##)";
Console.WriteLine(posValue.ToString(fmt));    // Displays 1234
Console.WriteLine(negValue.ToString(fmt));    // Displays (1234)

Deux sections

La première section s'applique aux valeurs positives et aux zéros, et la deuxième section s'applique aux valeurs négatives.

Si le nombre à mettre en forme est négatif, mais devient nul après l'arrondissement au format de la deuxième section, le zéro résultant est mis en forme en fonction de la première section.