Saltar al contenido
Biblioteca estándar

Internacionalización con Intl

Lección 3 de 712 min4 ejercicios

Un mismo precio se escribe 1.234,50 € en España, $1,234.50 en Estados Unidos y S/ 1,234.50 en Perú. Las fechas, los plurales y hasta el orden alfabético cambian de un idioma a otro. Intl trae todas esas reglas incorporadas: le dices el idioma y él se encarga del resto.

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

  • Intl conoce las reglas de cada idioma y país: dale un identificador como "es-PE".
  • NumberFormat: números, monedas (siempre con currency), porcentajes, unidades, notación compacta.
  • DateTimeFormat, RelativeTimeFormat y DurationFormat: fechas, “hace 3 días” y duraciones.
  • ListFormat une listas; PluralRules elige la forma del plural.
  • Collator ordena texto correctamente; DisplayNames traduce nombres de idiomas, regiones y monedas.

¡A practicar!

Tu progreso se guarda en este navegador.

Autoevaluación: Cada idioma, sus reglas

Elige una respuesta en cada pregunta.

  1. ¿Por qué no basta con n.toFixed(2) para mostrar un precio?

  2. ¿Qué hace Intl.RelativeTimeFormat?

  3. ¿Para qué sirve Intl.PluralRules?

  4. ¿Por qué ordenar con Intl.Collator en lugar de sort() a secas?

Ordena la salida: El mismo número, otros idiomas

Un número en dos idiomas, una lista y un tiempo relativo. Ordena lo que aparecería en la consola.

const n = 1234567.891; console.log(new Intl.NumberFormat("es-ES").format(n));console.log(new Intl.NumberFormat("en-US").format(n));console.log(new Intl.ListFormat("es", { type: "disjunction" }).format(["té", "café", "mate"]));console.log(new Intl.RelativeTimeFormat("es", { numeric: "auto" }).format(-1, "day"));

Consola, de arriba abajo

  1. té, café o mate
  2. 1.234.567,891
  3. ayer
  4. 1,234,567.891

Detective: Moneda sin moneda

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.

Laboratorio: Describir un carrito

Escribe describirCarrito con Intl.ListFormat e Intl.PluralRules.

programa.jsse ejecuta mientras escribes

$ node programa.js

(escribe tu código: se ejecuta solo)

Lo que debe cumplir

  • Imprime 3 productos: pan, leche y huevos y 1 producto: pan (pendiente)
  • Con dos: 2 productos: té y café (pendiente)
  • Usa Intl.ListFormat e Intl.PluralRules (pendiente)

    domina-js · JavaScript en español, gratis y paso a paso.