Volver a las notas

Intl.Locale info: el navegador ya conoce tu semana

21 de noviembre de 2026·
javascripti18nintlwebdev
Demo en vivoAbrir a pantalla completa

Es muy posible que tu selector de fechas empiece la semana en el día equivocado para buena parte de tus usuarios. Desde julio de 2026 todos los navegadores principales pueden decirte cuál es el correcto: new Intl.Locale("he-IL").getWeekInfo() devuelve { firstDay: 7, weekend: [5, 6] }. Eso es Intl Locale Info, ya Baseline, y se carga de un plumazo una categoría entera de tablas escritas a mano.

Prueba unos cuantos locales en la demo de arriba. El calendario se recoloca para empezar en el primer día de ese locale, las columnas del fin de semana se mueven, el reloj cambia entre 12 y 24 horas y el calendario se pone de derecha a izquierda con hebreo o árabe. Todos los valores salen directamente de tu navegador; el panel de código de abajo enseña lo que devuelve de verdad.

Qué es y por qué importa

Intl.Locale existe desde hace años, pero solo te decía lo que había dentro de una etiqueta: idioma, escritura, región. La propuesta Intl Locale Info añade métodos que responden preguntas sobre un locale, a partir de los datos de locale de Unicode:

  • getWeekInfo(): firstDay (1 = lunes … 7 = domingo) y weekend, un array con los números de día.
  • getHourCycles(): los ciclos horarios preferidos, como ["h12"] para en-US o ["h23"] para ja-JP.
  • getTextInfo(): { direction: "ltr" } o "rtl".
  • getCalendars(): los calendarios en uso, ordenados por preferencia.
  • getTimeZones(): las zonas horarias IANA de la región del locale.

También están getCollations() y getNumberingSystems(). La propuesta llegó a Stage 4 y forma parte de ECMA-402, 13.ª edición (junio de 2026).

Por qué importa: "la semana empieza en domingo" es falso en España, "el fin de semana es sábado y domingo" es falso en Israel y "usa reloj de 12 horas" es falso en casi toda Europa. Hasta ahora, o metías una tabla de equivalencias, o cargabas una librería de fechas casi solo para esto, o lo adivinabas.

Cómo funciona

Esto es el núcleo de la cabecera del calendario de la demo. firstDay usa la numeración ISO, así que construyo las siete etiquetas de columna a partir de él y dejo que Intl.DateTimeFormat ponga nombre a cada día:

const loc = new Intl.Locale(navigator.language);
const { firstDay, weekend } = loc.getWeekInfo();

const fmt = new Intl.DateTimeFormat(loc.baseName, { weekday: 'short', timeZone: 'UTC' });
const header = Array.from({ length: 7 }, (_, i) => {
  const isoDay = ((firstDay - 1 + i) % 7) + 1; // 1 = lunes … 7 = domingo
  return fmt.format(new Date(Date.UTC(2024, 0, isoDay))); // el 1 de enero de 2024 fue lunes
});
// en-US → ["Sun", "Mon", …]   es-ES → ["lun", "mar", …]

Un día es fin de semana cuando weekend.includes(isoDay), que es como la demo pinta las columnas en verde azulado. Ojo: getDay() devuelve 0 para el domingo, así que lo convierto con date.getDay() || 7.

Para el reloj, cojo el primer ciclo horario preferido y se lo paso a DateTimeFormat. Intl.DateTimeFormat ya elige un valor razonable al formatear, así que donde esto de verdad compensa es en tu propia interfaz: decidir si un selector de hora se abre en 12 o en 24 horas.

const [hourCycle] = loc.getHourCycles();
new Intl.DateTimeFormat(loc.baseName, { hour: 'numeric', minute: '2-digit', hourCycle });
// en-US → "6:05 PM"   es-ES → "18:05"

Y getTextInfo().direction es lo que usa la demo para poner dir="rtl" en el calendario.

El selector de región forzada de la demo usa la extensión rg de la etiqueta: en-US-u-rg-gbzzzz significa "inglés de Estados Unidos, pero con las preferencias regionales de Reino Unido". El mismo idioma, pero la semana empieza en lunes y el reloj pasa a 24 horas. Es una forma muy limpia de respetar a quien usa el navegador en inglés pero vive en otro sitio.

He ejecutado todos estos fragmentos en Chromium, Firefox y WebKit con Playwright, y los tres devuelven los mismos datos de semana.

Soporte en navegadores y trampas

Según los datos de compatibilidad de MDN, los métodos llegaron en Chrome 130, Safari 17 y, el último, Firefox 153, que es lo que convirtió la función en Baseline en julio de 2026. Node.js tiene los métodos desde la versión 24.

Cosas que te pueden morder:

  • La forma antigua con propiedades. Antes de los métodos, Chrome (desde la 99), Safari (desde la 15.4) y Node (desde la 18) los exponían como propiedades (loc.weekInfo, loc.hourCycles…). Se cambiaron a métodos porque cada acceso devolvía un objeto nuevo, así que loc.weekInfo === loc.weekInfo daba false. Si necesitas motores antiguos, ten un plan B: loc.getWeekInfo?.() ?? loc.weekInfo ?? { firstDay: 1, weekend: [6, 7] }. La demo hace exactamente eso y muestra un aviso cuando le toca.
  • minimalDays ya no está. La documentación antigua enseña una tercera propiedad para las reglas de semana del año. Se ha quitado de la especificación y se está quitando de los navegadores; ninguno de los tres motores que he probado la devuelve.
  • Sin región, sin zonas horarias. new Intl.Locale("es").getWeekInfo() sigue funcionando, pero getTimeZones() devuelve undefined cuando la etiqueta no lleva subetiqueta de región. Escribe ar en la demo y lo verás. Compruébalo antes de llamar a .length.
  • Son datos, no constantes. Los valores salen de los datos de locale de Unicode y los motores no siempre coinciden en los casos menos comunes: para he-IL, Chromium y WebKit incluyen islamic entre los calendarios y Firefox no. No escribas tests que fijen los arrays completos.
  • navigator.language es una suposición. Es el idioma de la interfaz del navegador, no el sitio donde vive la persona. Deja que el usuario cambie el primer día de la semana en los ajustes; usa esto como valor por defecto.

Qué vigilar

  • Que los selectores de fechas y los componentes de calendario dejen sus propias tablas de semanas y pasen a usar getWeekInfo().
  • Temporal, que encaja de forma natural con esto para hacer cálculos de fechas una vez sabes dónde empieza la semana.
  • Cómo mantienen los motores sincronizados sus datos de locale, porque diferencias pequeñas como la de la lista de calendarios pueden acabar viéndose en la interfaz.

Fuentes