Il metodo toLocaleString() di Javascript
Il metodo toLocaleString() restituisce la rappresentazione di una data (oggetto Date) nel linguaggio Javascript.
dateObj.toLocaleString([locale[, opzioni]])
Il metodo si applica a un oggetto di tipo Date qualsiasi e ha due parametri opzionali.
- locale è un parametro opzionale che indica le impostazioni regionali da utilizzare per la formattazione della data e dell'orario
- opzioni è un parametro opzionale per personalizzare la formattazione della data e dell'orario
Restituisce una rappresentazione testuale della data.
Nota. Se non specifico il parametro "locale", il metodo utilizza le impostazioni regionali predefinite del sistema operativo dell'utente. Viceversa, se lo specifico, il metodo rappresenta la data e l'orario nel formato standard utilizzato nella lingua indicata. Ad esempio "it-IT" per l'italiano in Italia, "en-EN" per l'inglese, ecc. Posso anche fornire un array con una lista di lingue preferite dall'utente in ordine di priorità. Il parametro "opzioni" contiene altre opzioni di formattazione molto utili. Ad esempio, l'indicatore "hour12" mi permette di visualizzare l'ora in formato a 12 o 24 ore.
Un esempio pratico
Questo script visualizza la data corrente secondo le impostazioni regionali italiane
<script>
const date = new Date();
const options = { hour12: false };
document.write(date.toLocaleString("it-IT", options));
</script>
Il formato standard in Italia è "gg/mm/aaaa, hh:mm:ss", dove "gg/mm/aaaa" rappresenta la data e "hh:mm:ss" rappresenta l'orario in formato a 24 ore.
Pertanto, lo script visualizza sullo schermo
27/4/2023, 19:06:00
Da notare che l'indicatore hour12 è settato su false, quindi l'ora viene visualizzata nel formato a 24 ore.
Esempio 2
Modifico lo script per visualizzare la stessa data in formato inglese
<script>
const date = new Date();
const options = { hour12: true };
document.write(date.toLocaleString("en-EN", options));
</script>
L'impostazione regionale predefinita in lingua inglese è il formato "mm/gg/aaaa, hh:mm:ss"
Pertanto, il mese viene visualizzato prima del giorno.
4/27/2023, 7:09:00 PM
In questo caso ho impostato l'indicatore hour12 su true e le ore sono visualizzate nel formato a 12 ore (AM/PM). Quindi, le "19" diventano le "7:00:00 PM".
Esempio 3
Questo script converte la data corrente in una stringa.
<script>
const date = new Date();
document.write(date.toLocaleString());
</script>
In questo caso non ho impostato nessun parametro.
Quindi, il metodo rappresenta la data in base alle impostazioni regionali del sistema operativo dell'utente.
4/27/2023, 7:14:52 PM
Essendo in Italia, il mio browser visualizza la data e l'orario nel formato italiano.
E così via.
