Devuelve una expresión con formato de porcentaje (múltiplo por 100) con un carácter % final.
Sintaxis
FormatPercent ( Expresión [, 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á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 tristate que indica si se muestra o no un cero a la izquierda para valores fraccionados. Vea la sección Configuración para ver los valores. |
|
UseParensForNegativeNumbers |
Opcional. Constante de tres estados que indica si se deben colocar o no valores negativos entre paréntesis. Vea la sección Configuración para ver los valores. |
|
GroupDigits |
Opcional. Constante tristate que indica si los números se agrupan o no con el delimitador de grupo especificado en la configuración regional del equipo. Vea la sección Configuración para ver los valores. |
Configuración
Los argumentos IncludeLeadingDigit, UseParensForNegativeNumbersy 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, la configuración regional del equipo proporciona los valores de los argumentos omitidos.
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; |
Da formato a los valores del campo "Percent" al formato "Porcentaje" y devuelve en la columna Expr1. |
|
SELECT FormatPercent([DPercent],2,-1,-1,-1) AS DPercentage FROM ProductSales; |
Da formato a los valores del campo "Percent" al formato "Porcentaje" con 2 puntos decimales, todos los valores inferiores al 1 % tendrán "0" antes de que los valores decimales negativos se abarque 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 %). |