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).

Precisa de mais ajuda?

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

Estas informações foram úteis?

Qual é o seu grau de satisfação com a qualidade da tradução?
O que afetou sua experiência?

Obrigado por seus comentários!

×