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