Devolve uma expressão formatada como um valor de moeda utilizando o símbolo de moeda definido no painel de controlo do sistema.
Sintaxe
FormatCurrency(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
A sintaxe da função FormatoMoeda tem estes argumentos:
| Argumento | Descrição |
|---|---|
| Expressão | Obrigatório. Expressão a ser formatada. |
| NumDigitsAfterDecimal | Opcional. Valor numérico que indica o número de casas à direita da vírgula decimal. O valor predefinido é –1, o que indica que estão a ser utilizadas as definições regionais do computador. |
| IncludeLeadingDigit | Opcional. Constante de triestado que indica se o zero à esquerda é ou não apresentado para valores fracionários. Consulte a secção Definições para obter os valores. |
| UseParensForNegativeNumbers | Opcional. Constante de triestado que indica se os valores negativos devem ou não ser colocados entre parênteses. Consulte a secção Definições para obter os valores. |
| GroupDigits | Opcional. Constante de triestado que indica se os números estão ou não agrupados utilizando o delimitador de grupo especificado nas definições regionais do computador. Consulte a secção Definições para obter os 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 a partir das definições regionais do computador. |
Observações
Quando um ou mais argumentos opcionais são omitidos, os valores para argumentos omitidos são fornecidos pelas definiçõ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.
Nota
Todas as informações de definições são provenientes do separador Moeda das Definições Regionais , exceto o zero à esquerda que provém do separador Número .
Exemplos
| Expressão | Resultados |
|---|---|
| SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales; | Formata os valores numéricos no campo "PreçoUnitário" no formato "Moeda" e devolve na coluna Expr1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) COMO DiscountedPrice FROM ProductSales; | Formata os valores numéricos no campo "Desconto" no formato "Moeda" com 2 casas decimais, todos os valores inferiores a 1 terão "0" antes do decimal, os valores negativos serão cobertos entre parênteses, o valor será agrupado pelo delimitador predefinido ("1000" será apresentado como 1 000,00 $, "-1000" será apresentado como 1 000,00 $), "0" será apresentado como 0,00 $). |