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