Devolve uma expressão formatada como um número.
Sintaxe
FormatNumber(Expression [, 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 quantas casas à direita do decimal são apresentadas. O valor predefinido é –1, o que indica que as definições regionais do computador são utilizadas. |
| IncludeLeadingDigit | Opcional. Constante triestado que indica se um zero à esquerda é ou não apresentado para valores fracionários. Veja a secção Definições para obter valores. |
| UseParensForNegativeNumbers | Opcional. Constante triestado que indica se deve ou não colocar valores negativos entre parênteses. Veja a secção Definições para obter valores. |
| GroupDigits | Opcional. Constante triestado que indica se os números estão ou não agrupados com o delimitador de grupo especificado nas definições regionais do computador. Veja a secção Definições para obter valores. |
Configurações
Os argumentos IncludeLeadingDigit, UseParensForNegativeNumbers e GroupDigits têm as seguintes definições:
| Constante | Valor | Descrição |
|---|---|---|
| vbTrue | –1 | Verdadeira |
| vbFalse | 0 | Falsa |
| vbUseDefault | –2 | Utilize a definição das definições regionais do computador. |
Comentários
Quando um ou mais argumentos opcionais são omitidos, os valores dos argumentos omitidos são fornecidos pelas definições regionais do computador.
Observação
Todas as informações de definições são provenientes do separador Número de Definições Regionais .
Exemplos
| Expressão. | Resultados |
|---|---|
| SELECT FormatNumber([SalePrice]) AS Expr1 FROM ProductSales; | Formatar os valores de moeda no campo "SalePrice" no formato "Number" e devolve na coluna Expr1. |
| SELECT FormatNumber([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Formatar os valores numéricos no campo "Desconto" no formato "Número" com 2 pontos decimais, todos os valores inferiores a 1 terão "0" antes do decimal, os valores negativos serão abrangidos entre parênteses, o valor será agrupado por delimitador predefinido ("1000" será apresentado como 1.000,00, "-1000" será apresentado como (1.000,00), "0" será apresentado como 0,00). |