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

CKTIS / JavaScript

Intl.DateTimeFormat: obtener las partes de una fecha con formatToParts()

Obtén las partes de una fecha u hora localizada para resaltar un campo como el mes sin dividir el texto por separadores ni dar por sentado el orden de los campos.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

formatter.formatToParts()
formatter.formatToParts(date)

formatToParts() es un método de instancia de Intl.DateTimeFormat, definido en Intl.DateTimeFormat.prototype, no un método estático del constructor. Llámalo con formatter.formatToParts(date). A diferencia de format(), no se vincula automáticamente a la instancia: llamar a la función extraída sin el this correcto lanza un TypeError.

Pasa un objeto Date o una marca de tiempo en milisegundos desde la época Unix, no en segundos. Si omites el argumento o pasas undefined, se usa la hora actual de Date.now(). Un Date no válido o una marca de tiempo fuera de rango provoca un RangeError. El método da formato a valores; no analiza texto que represente una fecha. Los entornos con integración de Temporal también pueden aceptar algunos tipos Temporal.Plain*; pasar directamente un Temporal.ZonedDateTime lanza un TypeError.

El resultado es un array de objetos { type, value } en orden de visualización; ambas propiedades son cadenas. Un type como month, day o year identifica un campo. literal indica texto del patrón, como una coma, un espacio o una palabra. En calendarios con años que tienen nombre, relatedYear (el año gregoriano correspondiente) puede sustituir a year, y el patrón también puede incluir yearName (el nombre del año).

Selecciona las partes por type, no por su índice. Para reproducir el resultado de format() con la misma instancia y la misma fecha, concatena todos los value sin separador, incluidos los de tipo literal. La configuración regional y opciones como el calendario y la zona horaria influyen en el resultado. La grafía y la puntuación exactas pueden variar entre entornos incluso con la misma configuración regional. No uses el resultado como formato de intercambio de datos.

Ejemplos

const formatter = new Intl.DateTimeFormat("en-US", {
  timeZone: "UTC",
  year: "numeric",
  month: "long",
  day: "numeric",
});
const date = new Date("2024-07-09T12:00:00Z");
const parts = formatter.formatToParts(date);

console.log(parts.some(({ type }) => type === "month"));
console.log(parts.map(({ value }) => value).join("") === formatter.format(date));

Resultado

true
true

El ejemplo fija la fecha, la configuración regional y la zona horaria UTC. El primer `true` confirma que hay una parte `month`; el segundo confirma que los valores concatenados coinciden con `format()`.

Lecciones relacionadas

  • JavaScript · Lección 15 · Básico · Versión: 4

Fuentes