Retorna uma expressão formatada como um valor de moeda usando o símbolo de moeda definido no painel de controle do sistema.
Sintaxe
FormatCurrency ( Expressão [, 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 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.
A posição do símbolo de moeda em relação ao valor da moeda é determinada pelas configurações regionais do sistema.
Observação: Todas as informações de configurações vêm da guia Moeda de Configurações Regionais, exceto zero à esquerda, que vem da guia Número.
Exemplos
|
Expressão |
Resultados |
|
SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales; |
Formatar os valores de número no campo "UnitPrice" no formato "Moeda" e retorna na coluna Expr1. |
|
SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; |
Formatar os valores de número no campo "Discount" no formato "Moeda" com 2 pontos decimais, todos os valores menores do 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). |
