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

CKTIS / JavaScript

Intl.DateTimeFormat — formato localizado de fechas y horas

Intl.DateTimeFormat formatea fechas y horas según las convenciones de una configuración regional y una zona horaria elegida. Aprende format(), formatToParts(), resolvedOptions() y la diferencia entre timeZone y hourCycle.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.formatToParts(date);
formatter.resolvedOptions();

Intl.DateTimeFormat pertenece al estándar de internacionalización ECMA-402, no a la API DOM. Crea un formateador con new Intl.DateTimeFormat(locales, options) y reutilízalo. Una configuración regional determina las convenciones de presentación; no selecciona automáticamente la zona horaria correspondiente a ese país.

Los nombres Intl.DateTimeFormat.format y Intl.DateTimeFormat.formatToParts se refieren aquí a operaciones de instancia, no a métodos estáticos del constructor. formatter.format(date) devuelve texto; la propiedad format es un accesor que proporciona una función vinculada. formatter.formatToParts(date) devuelve objetos { type, value } ordenados, incluidas las partes literal. Unir todos los valores value reconstruye format(date). No analices texto localizado dividiéndolo por separadores.

timeZone, por ejemplo UTC o Europe/Warsaw, selecciona la zona usada para mostrar el mismo instante, sin cambiar el objeto Date. Si se omite la opción, se usa la zona horaria del entorno. hourCycle selecciona el intervalo de horas: h11 es 0–11, h12 es 1–12, h23 es 0–23 y h24 es 1–24. Es relevante al formatear horas; si se especifica, la opción hour12 tiene prioridad.

Intl.DateTimeFormat.prototype.resolvedOptions, llamado como formatter.resolvedOptions(), expone los ajustes seleccionados realmente, incluidos locale, timeZone y, cuando el formato incluye horas, hourCycle. Los datos de configuración regional pueden variar entre entornos, así que no des por sentada una puntuación o unos espacios idénticos. El estándar no es una tabla de compatibilidad de navegadores: comprueba los métodos y opciones necesarios en tus entornos de destino; Node 24 no demuestra la compatibilidad con navegadores.

Ejemplos

const formatter = new Intl.DateTimeFormat('en-GB', {
  timeZone: 'UTC',
  numberingSystem: 'latn',
  hour: '2-digit',
  minute: '2-digit',
  hourCycle: 'h23'
});
const date = new Date('2024-01-02T00:05:00Z');
const parts = formatter.formatToParts(date);
const field = type => parts.find(part => part.type === type).value;
console.log(`${field('hour')}:${field('minute')}`);
console.log(parts.map(part => part.value).join('') === formatter.format(date));
console.log(formatter.resolvedOptions().hourCycle);

Resultado

00:05
true
h23

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes