Compartilhar via


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(Expression, [ NumDigitsAfterDecimal, [ IncludeLeadingDigit, [ UseParensForNegativeNumbers, [ GroupDigits ]]]])

A sintaxe da função FormatCurrency tem estas partes:

Sair Descrição
Expressão. Obrigatório. Expressão a ser formatada.
NumDigitsAfterDecimal Opcional. Valor numérico que indica quantas casas à direita da vírgula decimal são exibidas. O valor padrão é -1, que indica que as configurações regionais do computador são usadas.
IncludeLeadingDigit Opcional. Constante de três estados que indica se um zero à esquerda é exibido ou não para valores fracionários. Confira a seção Configurações para obter os valores.
UseParensForNegativeNumbers Opcional. Constante de três estados que indica se valores negativos devem ser colocados entre parênteses ou não. Confira a seção Configurações para obter os valores.
GroupDigits Opcional. Constante de três estados que indica se os números são agrupados ou não usando o delimitador de grupo especificado nas configurações regionais do computador. Confira a seção Configurações para obter os valores.

Configurações

Os argumentos IncludeLeadingDigit, UseParensForNegativeNumbers e 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 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 Configurações Regionais Conversor de Moedas, exceto zero à esquerda, que vem da guia Número.

Confira também

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.