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.