CKTIS / JavaScript
Intl.DateTimeFormat.prototype.format — formatear fechas y horas según la configuración regional
Usa `formatter.format()` para mostrar una fecha y una hora según una configuración regional y una zona horaria. El resultado es texto para mostrar, no para almacenar datos.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
const formatter = new Intl.DateTimeFormat(locales, options);
formatter.format(date);
formatter.format();
const format = formatter.format;
format(date);Llama a formatter.format(...) en una instancia de Intl.DateTimeFormat, no en el constructor. Crea un formateador con new Intl.DateTimeFormat(locales, options) para elegir la configuración regional, la zona horaria y los campos que se mostrarán. La llamada devuelve una cadena y no modifica el objeto Date. Si omites locales o timeZone, se usa el valor predeterminado correspondiente del entorno de ejecución.
En ECMA-402 (2024), pasa un objeto Date o una marca de tiempo numérica en milisegundos desde la época Unix, no en segundos. Si omites el argumento o pasas undefined, se formatea el instante actual en el momento de la llamada. format() no interpreta cadenas de fecha: convierte antes el texto en un Date válido o una marca de tiempo. Un Date no válido, NaN, un valor infinito o una marca de tiempo fuera del intervalo de Date provoca un RangeError.
Intl.DateTimeFormat.prototype.format es una propiedad con un getter. Leer formatter.format devuelve la misma función vinculada a esa instancia, así que puedes pasarla directamente como función de devolución de llamada, por ejemplo con dates.map(formatter.format), sin llamar a bind().
Los entornos con integración de Temporal también pueden formatear Temporal.PlainDateTime, Temporal.PlainDate, Temporal.PlainTime, Temporal.PlainYearMonth o Temporal.PlainMonthDay si el tipo es compatible con los ajustes del formateador. Temporal.ZonedDateTime provoca un TypeError; usa Temporal.ZonedDateTime.prototype.toLocaleString() para formatear el valor en su propia zona horaria.
Incluso con los mismos ajustes, la salida puede variar entre entornos, por ejemplo en los espacios, la puntuación o los caracteres de control bidireccional. No la compares con texto fijo en el código ni la uses como formato de intercambio de datos.
Ejemplos
const formatter = new Intl.DateTimeFormat("en-GB", {
year: "numeric",
month: "long",
day: "numeric",
timeZone: "UTC",
});
const date = new Date("2024-06-15T00:00:00Z");
const format = formatter.format;
const text = formatter.format(date);
console.log(typeof text);
console.log(text === format(date.getTime()));Resultado
string true
El ejemplo fija el instante, la configuración regional y la zona UTC. Comprueba el tipo del resultado y que la función llamada por separado formatea una marca de tiempo igual que la llamada sobre la instancia con el `Date` equivalente, sin dar por sentado el texto exacto.
Lecciones relacionadas
- JavaScript · Lección 15 · Básico · Versión: 4