CKTIS / JavaScript
Intl.DateTimeFormat.formatToParts(): partes de la fecha y la hora
Obtén las partes de una fecha u hora localizada para dar estilo a un componente sin suponer el orden de los campos ni dividir el texto según la puntuación.
Versión: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxis
formatter.formatToParts()
formatter.formatToParts(date)Intl.DateTimeFormat.prototype.formatToParts es un método de instancia de Intl.DateTimeFormat. En lugar de la cadena única que devuelve format(), proporciona un array de objetos { type, value } en orden de presentación. Ambas propiedades son cadenas. Si unes todos los value con join(""), obtienes el resultado de format() para el mismo formateador y la misma entrada. A diferencia de la función que devuelve format, formatToParts no se vincula automáticamente a la instancia. Pasa date => formatter.formatToParts(date) como función de callback o usa bind; un this incompatible provoca un TypeError.
Selecciona partes por type, como month o dayPeriod, no por índice. Conserva las partes literal: pueden contener espacios, signos de puntuación o palabras. En algunos calendarios, relatedYear (el año gregoriano correspondiente) sustituye a year, a veces junto a yearName (el nombre del año). Conserva también las partes desconocidas. La configuración regional, las opciones y los datos del entorno pueden cambiar el resultado. Usa las partes para mostrar información, no para interpretarla ni almacenarla. En el navegador, inserta los valores como texto con textContent, no con innerHTML.
En ECMA-402 para ECMAScript 2024, pasa un objeto Date o un número de milisegundos desde la época Unix. El método convierte el argumento en un número; no interpreta cadenas como fechas. Si omites el argumento o pasas undefined, se usa la hora actual en el momento de la llamada. Un Date no válido o una marca de tiempo fuera de rango provoca un RangeError.
Los entornos con integración de Temporal también aceptan Temporal.Instant y los tipos Temporal.Plain* especificados para este método, con restricciones de calendario y formato según el tipo. Comprueba la compatibilidad del entorno de destino. Pasar directamente un Temporal.ZonedDateTime provoca un TypeError. Para obtener las partes del mismo instante en su zona, pasa el resultado de toInstant() y configura timeZone del formateador con la zona de ese objeto.
Ejemplos
{
const formatter = new Intl.DateTimeFormat("en-US", {
timeZone: "UTC",
calendar: "gregory",
year: "numeric",
month: "long",
day: "numeric",
});
const date = new Date("2024-07-05T12: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 el instante, la configuración regional y la zona UTC. El primer `true` confirma que hay una parte `month`. El segundo confirma que los valores unidos coinciden con `format(date)`, sin suponer separadores concretos.
Lecciones relacionadas
- JavaScript · Lección 25 · Avanzado · Versión: 4