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 |
|---|---|
| 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 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). |