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 |
|---|---|
| Expresión | Obligatorio. 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. |
Observaciones
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
| Expresión | 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%). |