Compartilhar via


Formatos numéricos definidos pelo usuário (função Format)

A tabela a seguir identifica caracteres que você pode usar para criar formatos numéricos definidos pelo usuário.Eles podem ser usados para construir o Style argumento para o Format função:

Caracterer

Descrição

Nenhum

Exibe o número sem formatação.

(0)

Espaço reservado para dígito.Exibe um dígito ou um zero.Se a expressão tem um dígito na posição onde o zero é exibida no formato string, exibi-lo; caso contrário, exibe um zero na posição.

Se o número tiver menos dígitos que lá são zeros (nos dois lados da vírgula decimal) na expressão de formato, exibe entrelinhamento ou zeros à direita.Se o número tiver mais dígitos à direita do separador decimal que há zeros à direita do separador decimal na expressão de formato Arredonda o número para tantas casas decimais sistema autônomo há zeros.Se o número tiver mais dígitos à esquerda do separador decimal que há zeros à esquerda do separador decimal na expressão de formato, exibe os dígitos extras sem modificação.

(#)

Espaço reservado para dígito.Exibe um dígito ou nada.Se a expressão tiver um dígito na posição onde o # caractere aparece na seqüência de caracteres de formato, o exibe; caso contrário, exibe nada nessa posição.

Este símbolo funciona como a 0 espaço reservado para dígito, exceto que zeros entrelinhamento e à direita não são exibidos se o número tiver menos dígitos do que há # caracteres em ambos os lados do separador decimal na expressão de formato.

(.)

Espaço reservado decimal.O espaço reservado decimal determina quantos dígitos serão exibidos à esquerda e direita do separador decimal.Se a expressão de formato contiver apenas # caracteres à esquerda deste símbolo; números menores do que 1 começam com um separador decimal. Para exibir um zero na frente exibido com números fracionários, use zero sistema autônomo o primeiro espaço reservado para dígito entrelinhamento do separador decimal.Em alguns locais, uma vírgula é usada sistema autônomo separador decimal.O caractere real usado sistema autônomo um espaço reservado decimal na saída formatada depende do formato de número reconhecido por seu sistema.Dessa forma, você deve usar o período sistema autônomo o espaço reservado decimal em seus formatos mesmo se estiverem em uma localidade que usa uma vírgula sistema autônomo espaço reservado decimal.A seqüência de caracteres formatada aparecerá no formato correto para a localidade.

(%)

Espaço reservado de percentual.Multiplica a expressão por 100.O caractere de porcentagem (%) é inserido na posição onde ela aparece na seqüência de caracteres de formato.

(,)

Separador de milhar.O separador de milhar separa milhares de centenas dentro de um número que tem quatro ou mais casas à esquerda do separador decimal.Uso padrão do separador de milhar é especificado se o formato contiver um separador de milhar rodeado por espaços reservados para dígito (0 ou #).

Um separador de milhar imediatamente à esquerda do separador decimal (ou não um decimal for especificado) ou sistema autônomo a extrema direita de caractere de meio seqüência de caractere "aumentam o número dividindo-o por 1.000, arredondamento conforme necessário." Números menores do que 1.000 mas maior ou igual a 500 são exibidos sistema autônomo 1e menor do que 500 são exibidos sistema autônomo números 0. Dois separadores de milhar adjacentes nesta posição escala por um fator de 1 milhão e um fator adicional de 1.000 para cada separador adicional.

Vários separadores em qualquer posição Outros que imediatamente à esquerda do separador decimal ou à posição mais à direita na seqüência de caracteres são tratados simplesmente sistema autônomo especificando o uso de um separador de milhar.Em alguns locais, um ponto é usado sistema autônomo um separador de milhar.O caractere real usado sistema autônomo o separador de milhar na saída formatada depende do formato de número reconhecido por seu sistema.Assim, você deve usar o ponto-e-vírgula sistema autônomo separador de milhar em seus formatos mesmo se estiverem em uma localidade que usa um ponto sistema autônomo um separador de milhar.A seqüência de caracteres formatada aparecerá no formato correto para a localidade.

Por exemplo, considere as seguintes três seqüências de formato:

  • "#,0.", qual separador usa milhares para formatar o número de 100 milhões sistema autônomo seqüência de caracteres "100.000.000".

  • "#0,.", que usa o dimensionamento por um fator de mil para formatar o número de 100 milhões sistema autônomo seqüência de caracteres "100000".

  • "#,0,.", qual separador de usos de milhares e dimensionamento por mil para formatar o número de 100 milhões sistema autônomo seqüência de caracteres "100.000".

(:)

Separador de time.Em alguns locais, outros caracteres podem ser usados para representar o separador de time.O separador de time separa horas, minutos e segundos quando os valores de time são formatados.O caractere real usado sistema autônomo separador de time na saída formatada é determinado pelas configurações do seu sistema.

(/)

Separador de data.Em alguns locais, outros caracteres podem ser usados para representar o separador de data.O separador de data separa o dia, mês e ano quando os valores de data são formatados.O caractere real usado sistema autônomo separador de data na saída formatada é determinado pelas configurações do seu sistema.

(E-E+e-e+)

Formato científico.Se a expressão de formato contiver pelo menos um dígito espaço reservado (0 ou #) à esquerda de E-, E+, e-, ou e+, o número é exibido em formato científico e E ou e é inserido entre o número e seu expoente. O número de espaços reservados de dígito à esquerda determina o número de dígitos no expoente.Use E- ou e- para colocar um sinal de subtração ao lado de expoentes negativos. Use E+ ou e+ Coloque um sinal de subtração ao lado de expoentes negativos e um sinal de mais ao lado de expoentes positivos. Você também deve incluir espaços reservados para dígito à direita desse símbolo obter corretas de formatação.

-+$ ( )

Caracteres literal.Esses caracteres são exibidos exatamente sistema autônomo digitado na seqüência de caracteres de formato.Para exibir um caractere Outros que uma das listadas, preceda-o com uma barra invertida (\) ou coloque-o entre aspas duplas ("").

(\)

Exibe o próximo caractere na seqüência de caracteres de formato.Para exibir um caractere que tem um significado especial sistema autônomo um caractere literal, preceda-o com uma barra invertida (\). A barra invertida propriamente dito não é exibida.Usar uma barra invertida é igual a colocar o próximo caractere entre aspas duplas.Para exibir uma barra invertida, use duas barras invertidas (\\).

Exemplos de caracteres que não podem ser exibidos sistema autônomo caracteres literal são sistema autônomo caracteres de formatação de data e a formatação de time (a, c, d, h, m, n, p, q, s, t, w, y, /, e :), a formatação numérica caracteres ()#, 0, %, E, evírgula e ponto), e a formatação de seqüência de caracteres ()@, &, <, >, e !).

("ABC")

Exibe a seqüência de caracteres a entre aspas duplas ("").Para incluir uma seqüência no argumento de estilo de dentro do código, você deve usar Chr(34) para delimitar o texto (34é o código de caractere de aspas ("")).

Exemplo

A tabela a seguir contém algumas expressões de formato de exemplo para números.(Todos estes exemplos assumem que configuração de localidade do sistema é inglês-EUA) A primeira coluna contém as seqüências de caracteres de formato para o Style argumento das Format função; as outras colunas contêm a saída resultante se os dados formatados possuem o valor dado nos títulos de coluna.

Formato (Style)

"5" formatado sistema autônomo

"-5" formatado sistema autônomo

"0,5" formatado sistema autônomo

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

Requisitos

Namespace:Microsoft.VisualBasic

**Módulo:**Strings

Assembly: Visual Basic Runtime Library (em Microsoft.VisualBasic.dll)

Consulte também

Referência

Sumário de Manipulação de Strings

Resumo de conversão

Formatos diferentes para valores numéricos diferentes (função Format)

Função Format

Formatos Numéricos Predefinidos (Função de Formatação)

Formatos de data/time definidos pelo usuário (função Format)