Devolve uma expressão formatada como um valor de moeda com o símbolo de moeda definido no painel de controlo do sistema.
Sintaxe
FormatCurrency(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
A sintaxe da função FormatCurrency 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.
A posição do símbolo de moeda relativa ao valor de moeda é determinada pelas definições regionais do sistema.
Observação
Todas as informações de definições são provenientes do separador Definições Regionais Conversor de Moedas, exceto o zero à esquerda que vem do separador Número.
Exemplos
| Expressão. | Resultados |
|---|---|
| SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales; | Formatar os valores numéricos no campo "PreçoUnitário" no formato "Conversor de Moedas" e devolve na coluna Expr1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Formatar os valores numéricos no campo "Desconto" no formato "Conversor de Moedas" 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). |