El idioma
Todos los formateadores de Intl reciben primero un identificador de idioma (locale): "es" (español), "es-PE" (español de Perú), "en-US", "pt-BR"… Sin él, usan el del navegador o del sistema.
console.log(navigator.language ?? "(sin navegador)");
console.log(Intl.DateTimeFormat().resolvedOptions().locale);
Números, monedas y unidades
const n = 1234567.891;
console.log(new Intl.NumberFormat("es-ES").format(n));
console.log(new Intl.NumberFormat("es-PE", { style: "currency", currency: "PEN" }).format(49.9));
console.log(new Intl.NumberFormat("es", { style: "percent" }).format(0.256));
console.log(new Intl.NumberFormat("es", { notation: "compact" }).format(2500000));
console.log(new Intl.NumberFormat("es", { style: "unit", unit: "kilometer-per-hour" }).format(90));
console.log(new Intl.NumberFormat("es", { maximumFractionDigits: 1 }).format(3.14159));
Crea el formateador una vez y reutilízalo: crearlo cuesta más que usarlo.
Fechas y horas
const fecha = new Date(Date.UTC(2026, 10, 20, 18, 30));
console.log(new Intl.DateTimeFormat("es", { dateStyle: "full", timeZone: "UTC" }).format(fecha));
console.log(new Intl.DateTimeFormat("en-US", { dateStyle: "medium", timeZone: "UTC" }).format(fecha));
console.log(new Intl.DateTimeFormat("es", { hour: "numeric", minute: "2-digit", timeZone: "America/Lima" }).format(fecha));
Con Temporal, cada objeto tiene toLocaleString, que usa este mismo formateador.
Tiempo relativo y duraciones
const rel = new Intl.RelativeTimeFormat("es", { numeric: "auto" });
console.log(rel.format(-1, "day"), "·", rel.format(2, "week"), "·", rel.format(-3, "hour"));
const dur = new Intl.DurationFormat("es", { style: "long" });
console.log(dur.format({ hours: 1, minutes: 5 }));
Listas y plurales
console.log(new Intl.ListFormat("es").format(["pan", "leche", "huevos"]));
console.log(new Intl.ListFormat("es", { type: "disjunction" }).format(["té", "café"]));
const plural = new Intl.PluralRules("es");
const mensajes = { one: "mensaje nuevo", other: "mensajes nuevos" };
for (const n of [0, 1, 5]) {
console.log(n, mensajes[plural.select(n)]);
}
PluralRules devuelve una categoría ("zero", "one", "two", "few", "many" u "other"). El español usa dos; el árabe, las seis. Escribir n === 1 ? … : … solo funciona en algunos idiomas.
Ordenar texto
sort() sin comparador ordena por código Unicode: las mayúsculas van antes que las minúsculas y las letras con acento, al final. Intl.Collator ordena como una persona:
const nombres = ["Zoe", "ana", "Óscar", "ñandú", "Nicolás"];
console.log([...nombres].sort());
console.log([...nombres].sort(new Intl.Collator("es").compare));
console.log(new Intl.Collator("es", { sensitivity: "base" }).compare("Ana", "ána")); // 0: iguales
Nombres de idiomas, países y monedas
const idiomas = new Intl.DisplayNames("es", { type: "language" });
const regiones = new Intl.DisplayNames("es", { type: "region" });
const monedas = new Intl.DisplayNames("es", { type: "currency" });
console.log(idiomas.of("pt-BR"), "·", regiones.of("JP"), "·", monedas.of("PEN"));
Resumen
Intlconoce las reglas de cada idioma y país: dale un identificador como"es-PE".NumberFormat: números, monedas (siempre concurrency), porcentajes, unidades, notación compacta.DateTimeFormat,RelativeTimeFormatyDurationFormat: fechas, “hace 3 días” y duraciones.ListFormatune listas;PluralRuleselige la forma del plural.Collatorordena texto correctamente;DisplayNamestraduce nombres de idiomas, regiones y monedas.
¡A practicar!
Tu progreso se guarda en este navegador.
Autoevaluación: Cada idioma, sus reglas
Resuelto
Elige una respuesta en cada pregunta.
¿Por qué no basta con
n.toFixed(2)para mostrar un precio?¿Qué hace
Intl.RelativeTimeFormat?¿Para qué sirve
Intl.PluralRules?¿Por qué ordenar con
Intl.Collatoren lugar desort()a secas?
Ordena la salida: El mismo número, otros idiomas
Resuelto
Un número en dos idiomas, una lista y un tiempo relativo. Ordena lo que aparecería en la consola.
1const n = 1234567.891;2 3console.log(new Intl.NumberFormat("es-ES").format(n));4console.log(new Intl.NumberFormat("en-US").format(n));5console.log(new Intl.ListFormat("es", { type: "disjunction" }).format(["té", "café", "mate"]));6console.log(new Intl.RelativeTimeFormat("es", { numeric: "auto" }).format(-1, "day"));Consola, de arriba abajo
- té, café o mate
- 1.234.567,891
- ayer
- 1,234,567.891
En España, los miles se separan con punto y los decimales con coma; en Estados Unidos, al revés. ListFormat con disjunction une con "o", y RelativeTimeFormat convierte "-1 día" en "ayer".
Detective: Moneda sin moneda
Resuelto
Se quería mostrar un precio en soles. Encuentra la línea y elige el arreglo.
Consola
precios.js:1
const precio = new Intl.NumberFormat("es-PE", { style: "currency" });
^
TypeError: Currency code is required with currency style.Paso 1: toca la línea de código que causa el error.
Paso 2: ¿cómo lo arreglas?
Laboratorio: Describir un carrito
Resuelto
Escribe describirCarrito con Intl.ListFormat e Intl.PluralRules.
$ node programa.js
Lo que debe cumplir
- Imprime
3 productos: pan, leche y huevosy1 producto: pan(pendiente) - Con dos:
2 productos: té y café(pendiente) - Usa
Intl.ListFormateIntl.PluralRules(pendiente)
Una solución
1const lista = new Intl.ListFormat("es");2const plurales = new Intl.PluralRules("es");3const palabras = { one: "producto", other: "productos" };4 5function describirCarrito(productos) {6 const n = productos.length;7 return `${n} ${palabras[plurales.select(n)]}: ${lista.format(productos)}`;8}9 10console.log(describirCarrito(["pan", "leche", "huevos"]));11console.log(describirCarrito(["pan"]));Crear los formateadores una sola vez, fuera de la función, es más eficiente. Y el objeto palabras es fácil de traducir: en otro idioma, PluralRules podría devolver "few" o "many", y solo habría que agregar esas claves.