.toLocaleDateString

.toLocaleDateString() è un metodo dell’oggetto Date che ci restituisce una stringa la quale rappresenta una data in un formato localizzato.

In questo esempio uso la data odierna – recuperata utilizzando il costruttore new Date() – e la passo a .toLocaleDateString() assieme a:

1. La stringa in formato IETF (leggi informazioni sullo standard su Wikipedia), ossia lingua-PAESE;
2. le opzioni per il controllo del formato della data, come la lunghezza del nome del giorno o del mese.

// Get today date value
const today = new Date()
console.log(today) // Wed Feb 08 2023 23:26:49 GMT+0100 (Ora standard dell’Europa centrale)

// Italian date format
const localeIT = "it-IT"
const optionsIT = { weekday:"long", year: "numeric", month: "long", day: "numeric" }

// English / GB date format
const localeGB = "en-GB"
const optionsGB = { weekday:"long", year: "numeric", month: "long", day: "numeric" }

// get italian formatted date
const localDateIT = today.toLocaleDateString(localeIT, optionsIT)
console.log(localDateIT) // "mercoledì 8 febbraio 2023"

// get english / GB formatted date
const localDate = today.toLocaleDateString(localeGB, optionsGB)
console.log(localDateGB) // Wednesday, 8 February 2023

Nota bene: la data passata al metodo .toLocaleDateString() deve essere in un formato valido ISO 8601 (leggi informazioni sullo standard su Wikipedia), ad esempio 2023-02-08T00:00:00.000Z. Se proviamo a passare ad una variabile date un formato data non valido, come può essere "02-08-2023" riceveremo un errore di tipo TypeError come questo:

TypeError: date.toLocaleDateString is not a function. (In 'event.toLocaleDateString('it-IT', options)', 'event.toLocaleDateString' is undefined)

Un errore TypeError in genere indica che un’operazione non può essere eseguita perché un valore non è nel formato consentito.