Applies ToAccess para Microsoft 365 Access 2024 Access 2021 Access 2019 Access 2016

Devolve uma expressão formatada como um valor de moeda com o símbolo de moeda definido no painel de controlo do sistema.

Sintaxe

FormatCurrency ( Expression [, 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 quantas casas à direita do decimal são apresentadas. O valor predefinido é –1, o que indica que as definições regionais do computador são utilizadas.

IncludeLeadingDigit

Opcional. Constante triestado que indica se um zero à esquerda é ou não apresentado para valores fracionários. Veja a secção Definições para obter valores.

UseParensForNegativeNumbers

Opcional. Constante triestado que indica se deve ou não colocar valores negativos entre parênteses. Veja a secção Definições para obter valores.

GroupDigits

Opcional. Constante triestado que indica se os números estão ou não agrupados com o delimitador de grupo especificado nas definições regionais do computador. Veja a secção Definições para obter valores.

Definições

Os argumentos IncludeLeadingDigit, UseParensForNegativeNumbers e GroupDigits têm as seguintes definições:

Constante

Valor

Descrição

vbTrue

–1

Verdadeira

vbFalse

0

Falsa

vbUseDefault

–2

Utilize a definição das definições regionais do computador.

Observações

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

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

Nota:  Todas as informações de definições são provenientes do separador Moeda das Definições Regionais , exceto o zero à esquerda, proveniente do separador Número .

Exemplos

Expressão

Resultados

SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales;

Formatar os valores numéricos no campo "PreçoUnitário" no formato "Moeda" e devolve na coluna Expr1.

SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales;

Formatar os valores numéricos no campo "Desconto" no formato "Moeda" com 2 pontos decimais, todos os valores inferiores a 1 terão "0" antes do decimal, os valores negativos serão abrangidos entre parênteses, o valor será agrupado por delimitador predefinido ("1000" será apresentado como $1.000,00, "-1000" será apresentado como ($1.000,00), "0" será apresentado como $0,00).

Precisa de mais ajuda?

Quer mais opções?

Explore os benefícios da subscrição, navegue em cursos de formação, saiba como proteger o seu dispositivo e muito mais.

As comunidades ajudam-no a colocar e a responder perguntas, a dar feedback e a ouvir especialistas com conhecimentos abrangentes.