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

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

Fuentes