CKTIS / JavaScript
Intl.DateTimeFormat.formatToParts(): parti di data e ora
Ottieni le parti di una data o di un’ora localizzata per applicare uno stile a un componente senza presumere l’ordine dei campi né dividere il testo in base alla punteggiatura.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
formatter.formatToParts()
formatter.formatToParts(date)Intl.DateTimeFormat.prototype.formatToParts è un metodo di istanza di Intl.DateTimeFormat. Invece della singola stringa restituita da format(), restituisce un array di oggetti { type, value } nell’ordine di visualizzazione. Entrambe le proprietà sono stringhe. Unendo tutti i value con join("") ottieni il risultato di format() per lo stesso formattatore e lo stesso input. A differenza della funzione restituita da format, formatToParts non è associato automaticamente all’istanza. Passa date => formatter.formatToParts(date) come callback oppure usa bind; un this incompatibile genera un TypeError.
Seleziona le parti in base a type, per esempio month o dayPeriod, non in base all’indice. Conserva le parti literal: possono contenere spazi, punteggiatura o parole. In alcuni calendari relatedYear (l’anno gregoriano corrispondente) sostituisce year, talvolta insieme a yearName (il nome dell’anno). Conserva anche le parti sconosciute. Le impostazioni locali, le opzioni e i dati dell’ambiente di esecuzione possono modificare il risultato. Usa le parti per la visualizzazione, non per l’analisi o la memorizzazione. Nel browser inserisci i valori come testo con textContent, non con innerHTML.
In ECMA-402 per ECMAScript 2024, passa un Date o un numero di millisecondi dall’epoca Unix. Il metodo converte l’argomento in un numero, non interpreta le stringhe come date. Se ometti l’argomento o passi undefined, usa l’ora corrente al momento della chiamata. Un Date non valido o un timestamp fuori intervallo genera un RangeError.
Gli ambienti con integrazione di Temporal accettano anche Temporal.Instant e i tipi Temporal.Plain* specificati per il metodo, con restrizioni di calendario e formattazione che dipendono dal tipo. Verifica il supporto nell’ambiente di destinazione. Passare direttamente un Temporal.ZonedDateTime genera un TypeError. Per ottenere le parti dello stesso istante nel suo fuso orario, passa il risultato di toInstant() e imposta timeZone del formattatore sul fuso di quell’oggetto.
Esempi
{
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));
}Risultato
true true
L’esempio fissa l’istante, le impostazioni locali e il fuso UTC. Il primo `true` conferma la presenza di una parte `month`. Il secondo conferma che i valori uniti corrispondono a `format(date)`, senza presumere separatori specifici.
Lezioni correlate
- JavaScript · Lezione 25 · Avanzato · Versione: 4