Função FormatNumber

Retorna uma expressão formatada como um número.

Sintaxe

FormatNumber ( Expressão [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )

A sintaxe da função FormatNumber tem estes argumentos:

Argumento

Descrição

Expressão

Obrigatório. Expressão a ser formatada.

NumDigitsAfterDecimal

Opcional. Valor numérico que indica quantos locais à direita do decimal são exibidos. O valor padrão é –1, o que indica que as configurações regionais do computador são usadas.

IncludeLeadingDigit

Opcional. Constante tristate que indica se um zero à esquerda é exibido ou não para valores fracionais. Consulte a seção Configurações para saber os valores.

UseParensForNegativeNumbers

Opcional. Constante tristate que indica se deve ou não colocar valores negativos entre parênteses. Consulte a seção Configurações para saber os valores.

GroupDigits

Opcional. Constante tristate que indica se os números estão ou não agrupados usando o delimiter de grupo especificado nas configurações regionais do computador. Consulte a seção Configurações para saber os valores.


Configurações

Os argumentos IncludeLeadingDigit,UseParensForNegativeNumberse GroupDigits têm as seguintes configurações:

Constante

Valor

Descrição

vbTrue

–1

Verdadeira

vbFalse

0

Falsa

vbUseDefault

–2

Use a configuração das configurações regionais do computador.


Comentários

Quando um ou mais argumentos opcionais são omitidos, os valores dos argumentos omitidos são fornecidos pelas configurações regionais do computador.

Observação:  Todas as informações de configurações vêm da guia Número de Configurações Regionais.

Exemplos

Expressão

Resultados

SELECT FormatNumber([SalePrice]) AS Expr1 FROM ProductSales;

Formatar os valores de moeda no campo "SalePrice" no formato "Número" e retorna na coluna Expr1.

SELECT FormatNumber([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales;

Formatar os valores de número no campo "Discount" no formato "Número" com 2 pontos decimais, todos os valores menores que 1 terão "0" antes que o decimal, os valores negativos serão cobertos entre parênteses, o valor será agrupado por delimiter padrão ("1000" será exibido como 1.000,00, "-1000" será exibido como (1.000,00), "0" será exibido como 0,00).

Precisa de mais ajuda?

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×