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%). |