Devolve uma expressão formatada como número.
Sintaxe
FormatNumber(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
A sintaxe da função FormatoNúmero tem os seguintes argumentos:
| Argumento | Descrição |
|---|---|
| Expressão | Obrigatório. Expressão a ser formatada. |
| NumDigitsAfterDecimal | Opcional. Valor numérico que indica o número de casas à direita da vírgula decimal. O valor predefinido é –1, o que indica que estão a ser utilizadas as definições regionais do computador. |
| IncludeLeadingDigit | Opcional. Constante de triestado que indica se o zero à esquerda é ou não apresentado para valores fracionários. Consulte a secção Definições para obter os valores. |
| UseParensForNegativeNumbers | Opcional. Constante de triestado que indica se os valores negativos devem ou não ser colocados entre parênteses. Consulte a secção Definições para obter os valores. |
| GroupDigits | Opcional. Constante de triestado que indica se os números estão ou não agrupados utilizando o delimitador de grupo especificado nas definições regionais do computador. Consulte a secção Definições para obter os valores. |
Definiçõ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 a partir das definições regionais do computador. |
Observações
Quando um ou mais argumentos opcionais são omitidos, os valores para argumentos omitidos são fornecidos pelas definições regionais do computador.
Nota
Todas as informações de configurações vêm da guia Número de Configurações Regionais .
Exemplos
| Expressão | Resultados |
|---|---|
| SELECT FormatNumber([PreçoDeVenda]) COMO Expr1 FROM ProductSales; | Formata os valores de moeda no campo "PreçoDeVenda" no formato "Número" e devolve na coluna Expr1. |
| SELECT FormatNumber([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Formata os valores numéricos no campo "Desconto" no formato "Número" com 2 casas decimais, todos os valores inferiores a 1 terão "0" antes do decimal, os valores negativos serão cobertos entre parênteses, o valor será agrupado pelo delimitador padrão ("1000" será exibido como 1.000,00, "-1000" será exibido como (1.000,00), "0" será exibido como 0,00). |