Sequências de Caracteres de Formato Numérico Personalizado

Você pode criar uma seqüência de caracteres de formato numérico personalizado, que consiste em um ou mais personalizados numéricos especificadores, para definir como formatar dados numéricos. Uma seqüência de caracteres de formato numérico personalizado é qualquer cadeia de caracteres de formato não é um seqüência de caracteres de formato numérico padrão.

Seqüências de caracteres de formato numérico personalizado são suportadas por algumas sobrecargas do ToString o método de todos os tipos numéricos. Por exemplo, você pode fornecer uma seqüência de caracteres de formato numérico para o ToString(String) e ToString(String, IFormatProvider) métodos para a Int32 tipo. Também há suporte para seqüências de caracteres de formato numérico personalizado o.NET Framework composto recurso formatação, que é usado por alguns Write e WriteLine métodos para a Console e StreamWriter classes, o String.Format método e o StringBuilder.AppendFormat método.

A tabela a seguir descreve os especificadores de formato numérico personalizado e exibe um exemplo de saída produzido por cada especificador de formato. Consulte o anotações seção para obter informações adicionais sobre como usar seqüências de caracteres de formato numérico personalizado e o exemplo seção para obter uma ilustração abrangente de seu uso.

As seções a seguintes fornecem informações detalhadas sobre cada um dos especificadores de formato numérico personalizado.

"0" Especificador personalizado

"0" o especificador de formato personalizado serve como um símbolo de espaço reservado do zero. Se o valor que está sendo formatado tem um dígito na posição onde o zero aparece na seqüência de formato, que dígito é copiado para a seqüência de caracteres do resultado; Caso contrário, um zero aparece na seqüência de resultado. A posição do zero à esquerda antes do ponto decimal e o zero mais à direita após o ponto decimal determina o intervalo de dígitos que estão sempre presentes na seqüência de resultado.

O especificador "00" faz com que o valor a ser arredondado para o dígito mais próximo anterior ao decimal, onde o arredondamento para cima sempre é usado. Por exemplo, formatando 34.5 com "00" resultaria no valor 35.

O exemplo a seguir exibe vários valores são formatados usando seqüências de caracteres de formato personalizado que incluem espaços reservados para zero.

Dim value As Double

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

value = 1.2
Console.Writeline(value.ToString("0.00", CultureInfo.InvariantCulture))
' Displays 1.20
Console.WriteLine(value.ToString("00.00", CultureInfo.InvariantCulture))
' Displays 01.20
Console.WriteLine(value.ToString("00.00", _
                  CultureInfo.CreateSpecificCulture("da-DK")))
' Displays 01,20

value = .56
Console.WriteLine(value.ToString("0.0", CultureInfo.InvariantCulture))
' Displays 0.6

value = 1234567890
Console.WriteLine(value.ToString("0,0", CultureInfo.InvariantCulture))  
' Displays 1,234,567,890      
Console.WriteLine(value.ToString("0,0", 
                  CultureInfo.CreateSpecificCulture("el-GR")))  
' Displays 1.234.567.890

value = 1234567890.123456
Console.WriteLine(value.ToString("0,0.0", CultureInfo.InvariantCulture))    
' Displays 1,234,567,890.1  

value = 1234.567890
Console.WriteLine(value.ToString("0,0.00", CultureInfo.InvariantCulture))   
' Displays 1,234.57 

double value;

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

value = 1.2;
Console.WriteLine(value.ToString("0.00", CultureInfo.InvariantCulture));
// Displays 1.20
Console.WriteLine(value.ToString("00.00", CultureInfo.InvariantCulture));
// Displays 01.20
Console.WriteLine(value.ToString("00.00", 
                  CultureInfo.CreateSpecificCulture("da-DK")));
// Displays 01,20

value = .56;
Console.WriteLine(value.ToString("0.0", CultureInfo.InvariantCulture));
// Displays 0.6

value = 1234567890;
Console.WriteLine(value.ToString("0,0", CultureInfo.InvariantCulture)); 
// Displays 1,234,567,890      
Console.WriteLine(value.ToString("0,0", 
                  CultureInfo.CreateSpecificCulture("el-GR"))); 
// Displays 1.234.567.890

value = 1234567890.123456;
Console.WriteLine(value.ToString("0,0.0", CultureInfo.InvariantCulture));   
// Displays 1,234,567,890.1  

value = 1234.567890;
Console.WriteLine(value.ToString("0,0.00", CultureInfo.InvariantCulture));  
// Displays 1,234.57 

Volta à tabela

O "#" Especificador personalizado

O "#" o especificador de formato personalizado serve como um símbolo de espaço reservado de dígito. Se o valor que está sendo formatado tem um dígito na posição onde o sinal de libra aparece na seqüência de formato, que dígito é copiado para a seqüência de resultado. Caso contrário, nada é armazenado nessa posição na sequência de resultados.

Observe que este especificador nunca exibe um zero que não é um dígito significativo, mesmo se zero é o único dígito na seqüência de caracteres. Ele exibirá zero somente se ele for um dígito significativo no número que está sendo exibido.

O especificador "##" faz com que o valor a ser arredondado para o dígito mais próximo anterior ao decimal, onde o arredondamento para cima sempre é usado. Por exemplo, formatando 34.5 com "##" resultaria no valor 35.

O exemplo a seguir exibe vários valores são formatados usando seqüências de caracteres de formato personalizado que contêm espaços reservados de dígito.

      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

Volta à tabela

O "." Especificador personalizado

O "." o especificador de formato personalizado insere um separador decimal localizado na seqüência de resultado. O primeiro período na cadeia de caracteres de formato determina o local do separador decimal no valor formatado; qualquer períodos adicionais são ignorados.

O caractere usado como separador decimal na seqüência de resultado não é sempre um período; ele é determinado pelo NumberDecimalSeparator propriedade da NumberFormatInfo o objeto que controla a formatação.

O exemplo a seguir usa a "." especificador de formato para definir o local do ponto decimal em várias cadeias de caracteres de resultado.

      Dim value As Double

      value = 1.2
      Console.Writeline(value.ToString("0.00", CultureInfo.InvariantCulture))
      ' Displays 1.20
      Console.WriteLine(value.ToString("00.00", CultureInfo.InvariantCulture))
      ' Displays 01.20
      Console.WriteLine(value.ToString("00.00", _
                        CultureInfo.CreateSpecificCulture("da-DK")))
      ' Displays 01,20

      value = .086
      Console.WriteLine(value.ToString("#0.##%", CultureInfo.InvariantCulture)) 
      ' Displays 8.6%

      value = 86000
      Console.WriteLine(value.ToString("0.###E+0", CultureInfo.InvariantCulture))
       ' Displays 8.6E+4

      double value;

      value = 1.2;
      Console.WriteLine(value.ToString("0.00", CultureInfo.InvariantCulture));
      // Displays 1.20
      Console.WriteLine(value.ToString("00.00", CultureInfo.InvariantCulture));
      // Displays 01.20
      Console.WriteLine(value.ToString("00.00", 
                        CultureInfo.CreateSpecificCulture("da-DK")));
      // Displays 01,20

      value = .086;
      Console.WriteLine(value.ToString("#0.##%", CultureInfo.InvariantCulture)); 
      // Displays 8.6%

      value = 86000;
      Console.WriteLine(value.ToString("0.###E+0", CultureInfo.InvariantCulture));
       // Displays 8.6E+4

Volta à tabela

O "," Especificador personalizado

O "," caractere serve como um separador de grupo e de um especificador de número de dimensionamento.

• Separador de grupo: Se as vírgulas de um ou mais são especificadas entre dois espaços reservados para dígito (0 ou #) que os dígitos integrais de um número de formatação, um caractere separador de grupo é inserido entre cada grupo de números na parte integral da saída.

  As propriedades NumberGroupSeparator e NumberGroupSizes do atual objeto NumberFormatInfo determinam o caractere usado como separador de número de grupo e o tamanho de cada grupo de números. Por exemplo, se a sequência de caracteres "#, #" e a cultura invariável são usadas para formatar o número 1000, a saída será "1.000".

• Dimensionamento de especificador de número: Se um ou mais de vírgulas forem especificadas imediatamente à esquerda da vírgula decimal explícita ou implícita, o número a ser formatada é dividido por 1000 para cada vírgula. Por exemplo, se a sequência de caracteres "0,," é usada para formatar o número 100 milhões, a saída será "100".

Você pode usar o número de especificadores de dimensionamento e o separador de grupo na mesma seqüência de caracteres de formato. Por exemplo, se a sequência de caracteres "#, 0,," e a cultura invariável são usadas para formatar o número um bilhão, a saída será "1,000".

O exemplo a seguir ilustra o uso de vírgula como separador de grupo.

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       

O exemplo a seguir ilustra o uso da vírgula como um especificador para escala de numérica.

      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

Volta à tabela

"%" Especificador personalizado

Um sinal de porcentagem (%) em uma seqüência de formato faz com que um número a ser multiplicado por 100 antes de ser formatado. O símbolo de porcentagem localizado é inserido o número no local onde o % aparece na seqüência de formato. O caractere de porcentagem usado é definido pelo PercentSymbol a propriedade do atual NumberFormatInfo objeto.

O exemplo a seguir define várias cadeias de caracteres de formato personalizado que incluem "%" especificador de personalizado.

Dim value As Double = .086
Console.WriteLine(value.ToString("#0.##%", CultureInfo.InvariantCulture))
' Displays 8.6%      

double value = .086;
Console.WriteLine(value.ToString("#0.##%", CultureInfo.InvariantCulture));
// Displays 8.6%      

Volta à tabela

"‰" Especificador personalizado

Um por um caractere de mille (‰ ou \u2030) em uma seqüência de formato faz com que um número a ser multiplicado por 1.000 antes de ser formatado. Por um símbolo de mille apropriado é inserido na string retornada no local onde o símbolo ‰ aparece na seqüência de formato. O por mille o caractere usado é definido pelo NumberFormatInfo.PerMilleSymbol a propriedade do objeto que fornece informações de formatação específicas da cultura.

O exemplo a seguir define uma seqüência de caracteres de formato personalizado que inclui o "‰" especificador de personalizado.

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‰      

Volta à tabela

O "E" e "e" Especificadores personalizados

Se algum das seqüências de caracteres "E", "E +", "E-", "e", "e +" ou "e-" estão presentes na seqüência de caracteres de formato e são seguidos imediatamente pelo menos um zero, o número é formatado usando a notação científica com um "E" ou "e" inserido entre o número e o expoente. O número de zeros seguindo o indicador de notação científica determina o número mínimo de dígitos para o expoente de saída. "E +" e "e +" formatos de indicam um sinal de adição ou subtração sempre deve preceder o expoente. O "E", "E-", "e" ou "e-" formatos indicam que um caractere de sinal deve preceder somente ao lado dos expoentes negativos.

O exemplo a seguir formata vários valores numéricos usando os especificadores para notação científica.

Dim value As Double = 86000
Console.WriteLine(value.ToString("0.###E+0", CultureInfo.InvariantCulture))
' Displays 8.6E+4
Console.WriteLine(value.ToString("0.###E+000", CultureInfo.InvariantCulture))
' Displays 8.6E+004
Console.WriteLine(value.ToString("0.###E-000", CultureInfo.InvariantCulture))
' Displays 8.6E004

double value = 86000;
Console.WriteLine(value.ToString("0.###E+0", CultureInfo.InvariantCulture));
// Displays 8.6E+4
Console.WriteLine(value.ToString("0.###E+000", CultureInfo.InvariantCulture));
// Displays 8.6E+004
Console.WriteLine(value.ToString("0.###E-000", CultureInfo.InvariantCulture));
// Displays 8.6E004

Volta à tabela

O "\" Caractere de escape

The "#", "0", ".", ",", "%", and "‰" símbolos em uma seqüência de formato são interpretados como especificadores de formato, em vez de fazê-lo como caracteres literais. Dependendo de sua posição em uma seqüência de caracteres de formato personalizado, maiúscula e minúscula "E" Assim como a + e - símbolos também podem ser interpretados como especificadores de formato.

Para impedir que um caractere seja interpretado como um especificador de formato, você pode preceda com uma barra invertida, o que é o caractere de escape. O caractere de escape significa que o caractere é um caractere literal que deve ser incluído na seqüência de resultado inalterada.

Para incluir uma barra invertida em uma seqüência de resultado, você precisa isolá-lo com outra barra invertida (\\).

O exemplo a seguir usa o caractere de escape para impedir que a operação de formatação de interpretar o "#", "0" e "\" caracteres como caracteres de escape ou especificadores de formato. Os exemplos de C# usa uma barra invertida de adicional para garantir que uma barra invertida é interpretada como um caractere literal.

Dim value As Integer = 123
Console.WriteLine(value.ToString("\#\#\# ##0 dollars and \0\0 cents \#\#\#"))
' Displays ### 123 dollars and 00 cents ###
Console.WriteLine(value.ToString("\\\\\\ ##0 dollars and \0\0 cents \\\\\\"))
' Displays \\\ 123 dollars and 00 cents \\\

int value = 123;
Console.WriteLine(value.ToString("\\#\\#\\# ##0 dollars and \\0\\0 cents \\#\\#\\#"));
// Displays ### 123 dollars and 00 cents ###
Console.WriteLine(value.ToString(@"\#\#\# ##0 dollars and \0\0 cents \#\#\#"));
// Displays ### 123 dollars and 00 cents ###

Console.WriteLine(value.ToString("\\\\\\\\\\\\ ##0 dollars and \\0\\0 cents \\\\\\\\\\\\"));
// Displays \\\ 123 dollars and 00 cents \\\
Console.WriteLine(value.ToString(@"\\\\\\ ##0 dollars and \0\0 cents \\\\\\"));
// Displays \\\ 123 dollars and 00 cents \\\

Volta à tabela

O ";" Separador de seção

-E-vírgula (;) é um especificador de formato condicional se aplica a formatação diferente para um número de acordo com seu valor positivo, negativo ou zero. Para produzir esse comportamento, uma sequência de caracteres de formato personalizado pode conter até três seções separadas por ponto-e-vírgula. Essas operações são descritas na tabela a seguir.

Separadores de Seção ignoram qualquer formatação preexistente associada com um número quando o valor final é formatado. Por exemplo, valores negativos sempre são exibidos sem um sinal de subtração quando os separadores de seção são usados. Se você quiser o valor final formatado para ter um sinal de subtração, você deve incluir explicitamente o sinal de menos como parte de especificador de formato personalizado.

O exemplo a seguir usa a ";" Formate especificador de formato positivos, negativos e números de zero de uma forma diferente.

Dim posValue As Double = 1234
Dim negValue As Double = -1234
Dim zeroValue As Double = 0

Dim fmt2 As String = "##;(##)"
Dim fmt3 As String = "##;(##);**Zero**"

Console.WriteLine(posValue.ToString(fmt2))    ' Displays 1234
Console.WriteLine(negValue.ToString(fmt2))    ' Displays (1234)

Console.WriteLine(zeroValue.ToString(fmt3))   ' Displays **Zero**

double posValue = 1234;
double negValue = -1234;
double zeroValue = 0;

string fmt2 = "##;(##)";
string fmt3 = "##;(##);**Zero**";

Console.WriteLine(posValue.ToString(fmt2));    // Displays 1234
Console.WriteLine(negValue.ToString(fmt2));    // Displays (1234)

Console.WriteLine(zeroValue.ToString(fmt3));   // Displays **Zero**

Volta à tabela

Anotações

Pontos Flutuantes Infinitos e NaN (Não Números)

Independentemente da seqüência de caracteres de formato, se o valor de um Single ou Double tipo de ponto flutuante é infinito positivo, infinito negativo ou não um número (NaN), a seqüência de caracteres formatada é o valor do respectivo PositiveInfinitySymbol, NegativeInfinitySymbol, ou NaNSymbol propriedade especificada por aplicável no momento NumberFormatInfo objeto.

Configurações do Painel de controle

As configurações no item Opções regionais e de idioma no Painel de Controle influenciam a sequência de resultado produzida por uma operação de formatação. Essas configurações são usadas para inicializar o objeto NumberFormatInfo associado a cultura de segmento atual, que fornece valores usados para controlar a formatação. Computadores que usam diferentes configurações geram cadeias de caracteres de resultado diferente.

Além disso, se você usar o CultureInfo.CultureInfo(String) construtor para instanciar uma nova CultureInfo objeto que representa a cultura mesma como a cultura atual do sistema, todas as personalizações estabelecidas pelo regionais e idioma item no painel de controle será aplicada à nova CultureInfo objeto. Você pode usar o CultureInfo.CultureInfo(String, Boolean) construtor para criar um CultureInfo objeto que não reflete as personalizações de. um sistema

Arredondamento e Sequências de Caracteres de Formato Ponto-Fixo

Para seqüências de formato de ponto fixo (ou seja, a seqüências de formato que não contêm caracteres de formato de notação científica), os números são arredondados para tantas casas decimais como espaços reservados para dígito à direita do ponto decimal. Se a sequência de caracteres de formato não contiver um ponto decimal, o número será arredondado para o inteiro mais próximo. Se o número tiver mais dígitos do que houver espaços reservados de dígitos à esquerda do ponto decimal, os dígitos extras são copiados para a sequência de resultado imediatamente antes do primeiro espaço reservado para dígito.

Volta à tabela

Exemplo

O exemplo a seguir demonstra duas seqüências de caracteres de formato numérico personalizado. Em ambos os casos, o espaço reservado para dígito (#) exibe os dados numéricos e outros caracteres são copiados para a seqüência de resultado.

Dim number1 As Double = 1234567890
Dim value1 As String = number1.ToString("(###) ###-####")
Console.WriteLine(value1)

Dim number2 As Integer = 42
Dim value2 As String = number2.ToString("My Number = #")
Console.WriteLine(value2)
' The example displays the following output:
'       (123) 456-7890
'       My Number = 42

double number1 = 1234567890;
string value1 = number1.ToString("(###) ###-####");
Console.WriteLine(value1);

int number2 = 42;
string value2 = number2.ToString("My Number = #");
Console.WriteLine(value2);
// The example displays the following output:
//       (123) 456-7890
//       My Number = 42

Volta à tabela

Consulte também

Tarefas

Como: Acrescentar um número com zeros

Referência

NumberFormatInfo

Conceitos

Tipos de Formatação

Sequências de Caracteres de Formato Numérico Padrão

Histórico de alterações