Devuelve una expresión con formato de porcentaje (múltiplo por 100) con un carácter % final.
Sintaxis
FormatPercent ( Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La sintaxis de la función FormatPercent tiene estos argumentos:
|
Argumento |
Descripción |
|
Expression |
Requerido. Expresión a la que se va a dar formato. |
|
NumDigitsAfterDecimal |
Opcional. Valor numérico que indica cuántos lugares a la derecha del decimal se muestran. El valor predeterminado es -1, lo que indica que se usa la configuración regional del equipo. |
|
IncludeLeadingDigit |
Opcional. Constante tristate que indica si se muestra o no un cero a la izquierda para los valores fraccionarios. Vea la sección Configuración para los valores. |
|
UseParensForNegativeNumbers |
Opcional. Constante tristate que indica si se deben o no colocar valores negativos entre paréntesis. Vea la sección Configuración para los valores. |
|
GroupDigits |
Opcional. Constante Tristate que indica si los números se agrupan o no mediante el delimitador de grupo especificado en la configuración regional del equipo. Vea la sección Configuración para los valores. |
Configuración
Los argumentos IncludeLeadingDigit, UseParensForNegativeNumbers y GroupDigits tienen la configuración siguiente:
|
Constante |
Valor |
Descripción |
|
vbTrue |
–1 |
Verdadera |
|
vbFalse |
0 |
Falsa |
|
vbUseDefault |
–2 |
Use la configuración de la configuración regional del equipo. |
Comentarios
Cuando se omiten uno o varios argumentos opcionales, los valores de los argumentos omitidos se proporcionan mediante la configuración regional del equipo.
Nota: Toda la información de configuración proviene de la pestaña Número de configuración regional .
Ejemplos
|
Expression |
Resultados |
|
SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; |
Aplica formato a los valores del campo "DPercent" en el formato "Porcentaje" y devuelve en la columna Expresión1. |
|
SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; |
Da formato a los valores del campo "DPercent" en el formato "Porcentaje" con 2 decimales. todos los valores inferiores al 1 % tendrán "0" antes del decimal, los valores negativos se cubrirán entre paréntesis, el valor se agrupará de forma predeterminada ("10" se mostrará como 1.000,00 %, "-10" se mostrará como (1.000,00%), "0" se mostrará como 0,00%). |
