Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Intl.DateTimeFormat: leggere le opzioni effettive

Usa `resolvedOptions()` per sapere quali impostazioni di data e ora usa davvero un’istanza, senza doverle dedurre dagli argomenti passati al costruttore.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

formatter.resolvedOptions()

Intl.DateTimeFormat.prototype.resolvedOptions è un metodo di istanza senza argomenti. Ogni chiamata restituisce un nuovo oggetto ordinario con le impostazioni determinate alla creazione del formattatore. Modificare il risultato non cambia il formattatore. A differenza di format(), il metodo non accetta una data e non produce testo formattato. Chiamarlo senza associarlo all’istanza o con un this incompatibile, come {}, genera un TypeError.

Il risultato contiene locale (il tag di lingua BCP 47 effettivamente selezionato), calendar, numberingSystem e timeZone. Non è una copia dei dati passati al costruttore: la negoziazione delle impostazioni locali e i valori predefiniti possono cambiare il risultato. Senza un timeZone esplicito, alla creazione il formattatore adotta il fuso orario predefinito dell’ambiente di esecuzione. L’identificatore del fuso può essere normalizzato, quindi non è detto che coincida esattamente con la stringa fornita.

Senza dateStyle né timeStyle, proprietà come year, month e hour rispecchiano il modello selezionato; i componenti inutilizzati vengono omessi. Con dateStyle o timeStyle, il risultato indica gli stili richiesti senza scomporli nei singoli componenti. Combinare uno stile con un’opzione esplicita per un componente, come hour, genera un TypeError nel costruttore.

Se il modello include l’ora, il risultato contiene hourCycle e il valore derivato hour12, anche quando timeStyle fa sì che la proprietà hour non compaia. hour12 vale true per h11 e h12, e false per h23 e h24. Se il modello non include l’ora, entrambe le proprietà sono omesse. Nella scelta del ciclo, l’opzione hour12 prevale su hourCycle e sull’estensione Unicode hc.

Usa il risultato per individuare differenze tra ambienti di esecuzione. Il supporto delle opzioni e i dati locali possono variare, e opzioni effettive uguali non garantiscono un testo formattato identico.

Esempi

const formatter = new Intl.DateTimeFormat("en-GB", {
  timeZone: "UTC",
  timeStyle: "short",
  hour12: false,
});
const options = formatter.resolvedOptions();

console.log(options.timeZone);
console.log(options.timeStyle);
console.log(options.hour12);
console.log(Object.hasOwn(options, "hour"));

options.timeZone = "Asia/Tokyo";
console.log(formatter.resolvedOptions().timeZone);

Risultato

UTC
short
false
false
UTC

Il codice stampa, nell’ordine, `UTC`, `short`, `false`, `false` e `UTC`. Il primo `false` indica il formato a 24 ore; il secondo indica che non c’è una proprietà propria `hour`. L’assegnazione di `Asia/Tokyo` modifica soltanto l’oggetto restituito.

Lezioni correlate

  • JavaScript · Lezione 25 · Avanzato · Versione: 4

Fonti