Retorna uma expressão formatada como uma porcentagem (múltipla por 100) com um caractere % à direita.
Sintaxe
FormatPercent(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
A sintaxe da função FormatPercent tem esses argumentos:
| Argumento | Descrição |
|---|---|
| Expressão | Obrigatório. Expressão a ser formatada. |
| NumDigitsAfterDecimal | Opcional. Valor numérico que indica quantos lugares à direita do decimal são exibidos. O valor padrão é –1, o que indica que as configurações regionais do computador são usadas. |
| IncluirLeadingDigit | Opcional. Constante triestado que indica se um zero líder é exibido ou não para valores fracionários. Consulte Seção Configurações para obter valores. |
| UseParensForNegativeNumbers | Opcional. Constante triestual que indica se deve ou não colocar valores negativos dentro de parênteses. Consulte Seção Configurações para obter valores. |
| GroupDigits | Opcional. Constante triestado que indica se os números são agrupados ou não usando o delimitador de grupo especificado nas configurações regionais do computador. Consulte Seção Configurações para obter valores. |
Configurações
Os argumentos IncludeLeadingDigit, UseParensForNegativeNumbers e GroupDigits têm as seguintes configurações:
| Constante | Valor | Descrição |
|---|---|---|
| vbTrue | –1 | Verdadeira |
| vbFalse | 0 | Falsa |
| vbUseDefault | –2 | Use a configuração das configurações regionais do computador. |
Comentários
Quando um ou mais argumentos opcionais são omitidos, os valores para argumentos omitidos são fornecidos pelas configurações regionais do computador.
Observação
Todas as informações de configurações vêm da guia Número de Configurações Regionais .
Exemplos
| Expressão. | Resultados |
|---|---|
| SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; | Formata os valores no campo "DPercent" no formato "Percent" e retorna na coluna Expr1. |
| SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; | Formata os valores no campo "DPercent" no formato "Percent" com 2 pontos decimais, todos os valores inferiores a 1% terão "0" antes que os valores decimais e negativos sejam abordados em parênteses, o valor será agrupado por delimitador padrão ("10" será exibido como 1.000,00%, "-10" será exibido como (1.000,00%), "0" será exibido como 0,00%). |