Devuelve una expresión con formato de valor de moneda mediante el símbolo de moneda definido en el panel de control del sistema.
Sintaxis
FormatCurrency(Expression [, NumDigitsAfterDecimal ] [, IncludeLeadingDigit ] [, UseParensForNegativeNumbers ] [, GroupDigits ] )
La sintaxis de la función FormatoDivisa consta de 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.
La posición del símbolo de moneda en relación con el valor de la moneda viene determinada por la configuración regional del sistema.
Nota
Toda la información de configuración procede de la pestaña Configuración regional Moneda , excepto el cero inicial que procede de la pestaña Número .
Ejemplos
| Expresión | Resultados |
|---|---|
| SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales; | Aplica el formato de los valores numéricos del campo "PrecioUnidad" al formato "Moneda" y devuelve la columna Expr1. |
| SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; | Da formato a los valores numéricos del campo "Descuento" en formato "Moneda" 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á por delimitador predeterminado ("1000" se mostrará como $1.000,00, "-1000" se mostrará como ($1.000,00), "0" se mostrará como $0,00). |