Devolve uma expressão formatada como uma percentagem (multiplicada por 100) com um caráter % à direita.
Sintaxe
FormatPercent(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
A sintaxe da função FormatoPercentagem tem os seguintes 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.
Nota
Todas as informações de configurações vêm da guia Número de Configurações Regionais .
Exemplos
| Expressão | Resultados |
|---|---|
| SELECT FormatPercent([DPercent]) COMO Expr1 FROM ProductSales; | Formata os valores no campo "DPercent" no formato "Percentagem" e devolve na coluna Expr1. |
| SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; | Formata os valores no campo "DPercent" no formato "Percentagem" 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 padrão ("10" será exibido como 1.000,00%, "-10" será exibido como (1.000,00%), "0" será exibido como 0,00%). |