Devuelve una expresión con formato de valor de moneda usando 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 FormatCurrency 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.
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 Moneda de configuración regional , excepto el cero a la izquierda que viene de la pestaña Número .
Ejemplos
|
Expression |
Resultados |
|
SELECT FormatCurrency([UnitPrice]) AS Expr1 FROM ProductSales; |
Aplica formato a los valores numéricos del campo "PrecioUnidad" en el formato "Moneda" y devuelve en la columna Expr1. |
|
SELECT Formatcurrency([Discount],2,-1,-1,-1) AS DiscountedPrice FROM ProductSales; |
Aplica formato de moneda a los valores numéricos del campo "Descuento" 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 $). |
