Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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

Fonti