Devuelve una expresión con formato de número.
Sintaxis
FormatNumber ( Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La sintaxis de la función FormatoNumero 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. |
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
|
Expression |
Resultados |
|
SELECT FormatNumber([SalePrice]) AS Expr1 FROM ProductSales; |
Aplica formato a los valores de moneda del campo "PrecioVentas" en el formato "Número" y devuelve en la columna Expresión1. |
|
SELECT FormatNumber([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; |
Da formato a los valores numéricos del campo "Descuento" en el formato "Número" con 2 decimales, todos los valores inferiores a 1 tendrán "0" antes del decimal, los valores negativos se cubrirán entre paréntesis, el valor se agrupará de forma predeterminada como delimitador ("1000" se mostrará como 1.000,00, "-1000" se mostrará como (1.000,00), "0" se mostrará como 0,00). |
