Devuelve una expresión con formato de porcentaje (multiplicado por 100) con un carácter % final.
Sintaxis
FormatPercent(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La sintaxis de la función FormatoPorcentaje consta de los siguientes argumentos:
| Argumento | Descripción |
|---|---|
| expresión | Obligatorio. Expresión a la que se va a dar formato. |
| NumDigitsAfterDecimal | Opcional. Valor numérico que indica cuántas posiciones 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 de tres estados que indica si se muestra o no un cero inicial para valores fraccionarios. Consulte la sección Configuración para ver los valores. |
| UseParensForNegativeNumbers | Opcional. Constante de tres estados que indica si se van a colocar o no valores negativos entre paréntesis. Consulte la sección Configuración para ver 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. Consulte la sección Configuración para ver los valores. |
Configuración
Los argumentos IncludeLeadingDigit, UseParensForNegativeNumbers y GroupDigits tienen la siguiente configuración:
| Constante | Valor | Descripción |
|---|---|---|
| vbTrue | –1 | Verdadera |
| vbFalse | 0 | Falsa |
| vbUseDefault | –2 | Use la configuración de la configuración regional del equipo. |
Observaciones
Cuando se omiten uno o varios argumentos opcionales, los valores de los argumentos omitidos los proporciona la configuración regional del equipo.
Nota
Toda la información de configuración procede de la pestaña Número de configuración regional .
Ejemplos
| Expresión | Resultados |
|---|---|
| SELECT FormatPercent([DPercent]) AS Expr1 FROM ProductSales; | Da formato a los valores del campo "DPercent" en formato "Porcentaje" y devuelve la columna Expr1. |
| SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; | Da formato a los valores del campo "DPercent" en formato "Porcentaje" con 2 separadores decimales, todos los valores menores al 1% tendrán "0" antes del decimal, los valores negativos se cubrirán entre paréntesis, el valor se agrupará de forma predeterminada delimitador ("10" se mostrará como 1.000,00%, "-10" se mostrará como (1.000,00%), "0" se mostrará como 0,00%). |