Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Intl.NumberFormat: opciones de moneda y porcentaje

Formatea importes y proporciones según la configuración regional. Aprende cuándo es obligatorio el código de moneda, por qué 0,125 representa el 12,5 % y cómo controlar los decimales.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

new Intl.NumberFormat(locale, { style: "currency", currency: "USD" }).format(amount)
new Intl.NumberFormat(locale, { style: "percent", minimumFractionDigits: 1, maximumFractionDigits: 1 }).format(ratio)

new Intl.NumberFormat(locale, options) crea un formateador reutilizable; format(value) devuelve texto localizado. La configuración regional influye, por ejemplo, en los separadores y la posición de los símbolos. style elige el tipo de presentación y su valor predeterminado es "decimal".

Con style: "currency", indica en currency un código como "USD". Pasa el importe en unidades monetarias principales, no en centavos: el formato no convierte divisas. Si omites el código, se produce un TypeError; si no consta de tres letras ASCII, se produce un RangeError. Un código bien formado no tiene por qué estar asignado a una moneda. currencyDisplay selecciona "symbol" (predeterminado), "narrowSymbol" (símbolo corto), "code" o "name". currencySign es "standard" de forma predeterminada; "accounting" puede mostrar importes negativos entre paréntesis, según la configuración regional.

Con style: "percent", pasa una proporción: el formato la multiplica por 100 antes de redondearla. Para mostrar 12,5 %, pasa 0.125, no 12.5. Con notación estándar y sin configurar los dígitos significativos, la cantidad predeterminada de decimales depende de la unidad fraccionaria de la moneda (dos para USD); el porcentaje no tiene decimales de forma predeterminada. minimumFractionDigits rellena con ceros si hace falta; maximumFractionDigits limita los decimales al redondear. Con el ajuste predeterminado trailingZeroDisplay: "auto", asigna el mismo valor a ambas opciones para mostrar exactamente esa cantidad de decimales. Con trailingZeroDisplay: "stripIfInteger", se omite la parte decimal si el resultado redondeado es un número entero.

Los datos regionales y la compatibilidad del entorno de ejecución pueden variar. Los espacios y símbolos pueden diferir incluso con la misma configuración regional, así que evita comparar toda la cadena localizada con una constante. Usa formatToParts() para inspeccionar los componentes por tipo.

Ejemplos

const locale = "en-US-u-nu-latn";
const money = new Intl.NumberFormat(locale, {
  style: "currency",
  currency: "USD",
  currencyDisplay: "code",
});
const percent = new Intl.NumberFormat(locale, {
  style: "percent",
  minimumFractionDigits: 1,
  maximumFractionDigits: 1,
});

const moneyParts = money.formatToParts(19.9);
const percentParts = percent.formatToParts(0.125);
const valueOf = (parts, type) => parts.find(part => part.type === type)?.value;

console.log(JSON.stringify([
  valueOf(moneyParts, "currency"),
  valueOf(moneyParts, "integer"),
  valueOf(moneyParts, "fraction"),
]));
console.log(JSON.stringify([
  valueOf(percentParts, "integer"),
  valueOf(percentParts, "fraction"),
  percentParts.some(part => part.type === "percentSign"),
]));

Resultado

["USD","19","90"]
["12","5",true]

La primera línea muestra el código USD y las dos partes del importe, incluido el cero final. La segunda muestra las partes numéricas de 12,5 % y confirma que hay un signo de porcentaje sin comprobar su carácter exacto ni su posición.

Lecciones relacionadas

  • JavaScript · Lección 24 · Intermedio · Versión: 3

Fuentes