Devolve uma expressão formatada como uma percentagem (múltipla por 100) com um caráter % à direita.
Sintaxe
FormatPercent ( Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
A sintaxe da função FormatPercent 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.
Nota: Todas as informações de definições são provenientes do separador Número de Definições Regionais .
Exemplos
|
Expressão |
Resultados |
|
SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; |
Formatar os valores no campo "DPercent" no formato "Percentagem" e devolve na coluna Expr1. |
|
SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; |
Formatar os valores no campo "DPercent" no formato "Percentagem" com 2 pontos decimais, todos os valores inferiores a 1% terão "0" antes de os valores decimais negativos serem cobertos entre parênteses, o valor será agrupado por delimitador predefinido ("10" será apresentado como 1000,00%, "-10" será apresentado como (1000,00%), "0" será apresentado como 0,00%). |
