Se a propriedade Format não começar com um sinal de porcentagem (%) e não contiver nenhum símbolo (@), a formatação será de acordo com os códigos de formatação numérica. Essa formatação espera que a String seja um valor de ponto flutuante. Os seguintes especificadores de formato são suportados na propriedade Format:
|
Especificador |
Descrição |
|---|---|
|
Espaço reservado para dígitos '0' |
Se o valor que está sendo formatado possui um dígito na posição em que o '0' aparece na string de formato, esse dígito é copiado para a string de saída. Caso contrário, um '0' é armazenado nessa posição na sequência de saída. |
|
# Espaço reservado de dígitos |
Se o valor que está sendo formatado possui um dígito na posição em que o '0' aparece na string de formato, esse dígito é copiado para a string de saída. Caso contrário, nada será armazenado nessa posição na sequência de saída. |
|
. Ponto decimal |
O primeiro caractere '.' na string de formato determina a localização do separador decimal no valor formatado; quaisquer caracteres '.' adicionais são ignorados. |
|
, Mil separador |
Se o string de formato contiver um ou mais caracteres ',', a saída terá mil separadores inseridos entre cada grupo de três dígitos à esquerda do ponto decimal. O posicionamento e o número de caracteres ',' no string de formato não afetam a saída, exceto para indicar que mil separadores são usados. |
|
Notação científica E+ |
Se algum dois strings 'E +', 'E-', 'e +' ou 'e-' estiver contido no string de formato, o número será formatado usando notação científica. Um grupo de até quatro caracteres '0' pode seguir imediatamente o 'E +', 'E-', 'e +' ou 'e-' para determinar o número mínimo de dígitos no expoente. Os formatos 'E +' e 'e +' fazem com que um sinal de mais seja emitido para expoentes positivos e um sinal de menos seja gerado para expoentes negativos. Os formatos 'E-' e 'e-' produzem um caractere de sinal apenas para expoentes negativos. |
|
'xx'/"xx" |
Os caracteres entre aspas simples ou duplas são lançados como estão e não afetam a formatação. |
|
; |
Esse caractere separa números positivos, negativos e zero na seqüência de caracteres do formato. |
Os locais do '0' mais à esquerda antes do ponto decimal no string de formato e o '0' mais à direita após o ponto decimal no string de formato determinam o intervalo de dígitos que sempre estão presentes no string de saída.
O número que está sendo formatado é sempre arredondado para o número de casas decimais que houver espaços reservados de dígitos ('0' ou '#') à direita do ponto decimal. Se a sequência de formatação não contiver ponto decimal, o valor que está sendo formatado será arredondado para o número inteiro mais próximo.
Se o número que está sendo formatado tiver mais dígitos à esquerda do separador decimal do que existem espaços reservados de dígitos à esquerda do '.' caractere no string de formato, os dígitos extras são exibidos antes do espaço reservado para o primeiro dígito.
Para permitir formatos diferentes para valores positivos, negativos e zero, a sequência de formatos pode conter entre uma e três seções separadas por ponto e vírgula:
- Uma seção: o string de formato se aplica a todos os valores.
- Duas seções: a primeira seção se aplica a valores positivos e zeros, e a segunda seção se aplica a valores negativos.
- Três seções: a primeira seção se aplica a valores positivos, a segunda se aplica a valores negativos e a terceira se aplica a zeros.
Se a seção para valores negativos ou a seção para valores zero estiver vazia, ou seja, não há nada entre os pontos e vírgulas que delimitam a seção, a seção para valores positivos é usada.
Se a seção para valores positivos estiver vazia ou se todo o string de formatação estiver vazio, o valor será formatado usando a formatação geral de ponto flutuante com 15 dígitos significativos. A formatação geral de ponto flutuante também é usada se o valor tiver mais de 18 dígitos à esquerda do ponto decimal e a sequência de formatação não especificar notação científica.
A tabela a seguir lista exemplos de valores inseridos nas propriedades de formato e sequência:
|
Propriedade Format |
Propriedade String: 1234 |
Propriedade String: -1234 |
Propriedade String: 0.5 |
Propriedade 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 |