Il metodo setUTCMonth() di Javascript

Il metodo setUTCMonth() è una funzione dell'oggetto Date in Javascript che consente di configurare il mese di un dato anno, basandosi sul tempo universale coordinato (UTC).

oggetto.setUTCMonth(monthValue)

In questa sintassi, 'oggetto' rappresenta un'istanza dell'oggetto Date, mentre 'monthValue' tra le parentesi tonde è un numero intero che indica il mese (dove 0 è gennaio e 11 è dicembre).

Se il valore di monthValue supera 11, il metodo setUTCMonth() avanza automaticamente all'anno successivo.

Questo metodo modifica l'oggetto Date a cui è applicato rispettando l'orario UTC, quindi non è influenzato dai fusi orari locali. Per manipolare date considerando il fuso orario locale, è opportuno usare il metodo setMonth() al posto di setUTCMonth().

Per illustrare, supponiamo di creare un oggetto Date con la data 16 ottobre:

let esempio = new Date('2023-10-16T12:00:00Z');

Successivamente, uso il metodo setUTCMonth() per cambiare il mese, impostandolo a dicembre (11).

esempio.setUTCMonth(11);

Dopo di che, mostro la data contenuta nell'oggetto:

document.write(prova.toUTCString());

Ora, l'oggetto riflette la data 16 dicembre.

Sat, 16 Dec 2023 12:00:00 GMT

Esempio 2

Se imposto un valore per il mese che eccede 11, il metodo passerà all'anno successivo.

Supponiamo di inizializzare ancora una volta un oggetto Date con la data 16 ottobre:

let esempio = new Date('2023-10-16T12:00:00Z');

Stavolta, modifico il mese utilizzando il metodo setUTCMonth() impostandolo a 13.

esempio.setUTCMonth(13);

Quindi, visualizzo la data dell'oggetto:

document.write(esempio.toUTCString());

Poiché 12 rappresenta dicembre, al valore 13 il metodo aggiunge un mese all'anno successivo.

Di conseguenza, la data risultante nell'oggetto è il 16 gennaio dell'anno seguente.

Sat, 16 Jan 2024 12:00:00 GMT