Função FormatCurrency

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 os seguintes argumentos:

Argumento

Descrição

Expressão

Obrigatório. Expressão a ser formatada.

NumDigitsAfterDecimal

Opcional. Valor numérico indicando quantos locais à direita do decimal são exibidos. O valor padrão é – 1, que indica que as configurações regionais do computador são usadas.

IncludeLeadingDigit

Opcional. Constante Tristate que indica se um zero à esquerda é exibido para valores fracionários. Consulte a seção configurações para ver os valores.

UseParensForNegativeNumbers

Opcional. Constante Tristate que indica se deve ou não colocar valores negativos dentro dos parênteses. Consulte a seção configurações para ver os valores.

GroupDigits

Opcional. Constante Tristate que indica se os números são agrupados usando o delimitador de grupo especificado nas configurações regionais do computador. Consulte a seção configurações para ver os valores.


Configurações

Os argumentos IncludeLeadingDigit, UseParensForNegativeNumberse GroupDigits têm as seguintes configurações:

Constante

Valor

Descrição

vbTrue

– 1

True

vbFalse

0

False

vbUseDefault

– 2

Use a configuração das configurações regionais do computador.


Comentários

Quando um ou mais argumentos opcionais forem omitidos, os valores dos argumentos omitidos serão fornecidos pelas configurações regionais do computador.

A posição do símbolo de moeda em relação ao valor de moeda é determinada pelas configurações regionais do sistema.

Observação:  Todas as informações de configuração vêm da guia moeda de configurações regionais , exceto zero à esquerda, que vem da guia número .

Exemplos

Expressão

Resultados

Selecione FormatCurrency ([PreçoUnitário]) como expr1 do ProductSales;

Formata os valores numéricos no campo "UnitPrice" para o formato "Currency" e retorna na coluna expr1.

Selecione FormatCurrency ([desconto], 2,-1,-1,-1) como DiscountedPrice de ProductSales;

Formata os valores de número no campo "desconto" para o formato "Currency" com 2 casas decimais, e todos os valores menores que 1 terão "0" antes da vírgula decimal, os valores negativos serão cobertos entre parênteses, o valor será agrupado por delimitador padrão ("1000" será exibido como $1000, "-1000" será exibido como ($1000), "0" será exibido como $0).

Observação:  Esta página foi traduzida automaticamente e pode apresentar erros gramaticais ou imprecisões. Nosso objetivo é que este conteúdo seja útil para você. Você pode nos dizer se as informações foram úteis? Use o artigo em inglês como referência.​

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

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×