CKTIS / JavaScript
Intl.DateTimeFormat: ottenere le parti di una data con formatToParts()
Ottieni le parti di una data o di un orario localizzati per mettere in evidenza un campo come il mese, senza dividere il testo in base ai separatori o presumere l’ordine dei campi.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
formatter.formatToParts()
formatter.formatToParts(date)formatToParts() è un metodo di istanza di Intl.DateTimeFormat, definito su Intl.DateTimeFormat.prototype, non un metodo statico del costruttore. Chiamalo con formatter.formatToParts(date). A differenza di format(), non è associato automaticamente all’istanza: chiamare la funzione estratta senza il this corretto genera un TypeError.
Passa un oggetto Date o un timestamp in millisecondi dall’epoca Unix, non in secondi. Se ometti l’argomento o passi undefined, viene usato l’istante corrente fornito da Date.now(). Un Date non valido o un timestamp fuori intervallo genera un RangeError. Il metodo formatta i valori, non interpreta il testo di una data. Gli ambienti con integrazione di Temporal possono accettare anche alcuni tipi Temporal.Plain*; passare direttamente un Temporal.ZonedDateTime genera un TypeError.
Il risultato è un array di oggetti { type, value } nell’ordine di visualizzazione; entrambe le proprietà sono stringhe. Un type come month, day o year identifica un campo. literal indica un testo del modello, come una virgola, uno spazio o una parola. Nei calendari in cui gli anni hanno un nome, relatedYear (l’anno gregoriano corrispondente) può sostituire year, e il modello può includere anche yearName (il nome dell’anno).
Seleziona le parti in base a type, non all’indice nell’array. Per riprodurre il risultato di format() con la stessa istanza e la stessa data, unisci tutti i value senza separatore, inclusi quelli di tipo literal. Le impostazioni locali e opzioni come il calendario e il fuso orario influenzano il risultato. Grafia e punteggiatura possono variare tra ambienti anche con le stesse impostazioni locali. Non usare il risultato come formato di scambio dei dati.
Esempi
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));Risultato
true true
L’esempio fissa la data, le impostazioni locali e il fuso orario UTC. Il primo `true` conferma la presenza di una parte `month`; il secondo conferma che i valori concatenati corrispondono a `format()`.
Lezioni correlate
- JavaScript · Lezione 15 · Base · Versione: 4