Il metodo setUTCFullYear() di Javascript

Il metodo setUTCFullYear() è una funzionalità dell'oggetto Date in Javascript che consente di stabilire l'anno, basandosi sul tempo universale coordinato (UTC) per una data definita.

oggetto.setUTCFullYear(yearValue)

L'oggetto rappresenta un'istanza del tipo Date e l'argomento yearValue, inserito tra le parentesi tonde, è un numero intero che indica l'anno.

Questo metodo modifica soltanto l'anno, ma se nel cambiamento si genera una data inesistente, come il 29 febbraio in un anno non bisestile, JavaScript effettuerà un'adeguata correzione.

Questa funzionalità aggiorna direttamente l'oggetto Date basandosi sull'orario UTC, e quindi non considera i fusi orari del luogo. Per operare con date e orari locali, si dovrebbe ricorrere al metodo setFullYear() invece di setUTCFullYear().

Per illustrare, supponiamo di creare un oggetto di tipo date con la data del 16 ottobre 2023:

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

Successivamente, utilizzo il metodo setUTCFullYear() per variare l'anno, impostandolo a 2025.

esempio.setUTCFullYear(2025);

Dopodiché, visualizzo il valore dell'oggetto:

document.write(esempio.toUTCString());

La data conservata nell'oggetto risulta ora essere il 16 ottobre 2025.

Fri, 16 Oct 2025 12:00:00 GMT

Esempio 2

Se volessi cambiare l'anno a un valore che genera una data inesistente, JavaScript effettuerà un'adeguata correzione.

Ad esempio, istanziao un oggetto di tipo date con la data del 29 febbraio 2020, un anno bisestile.

let esempio = new Date('2020-02-29T12:00:00Z');

Poi, cambio l'anno dell'oggetto utilizzando il metodo setUTCFullYear(), impostandolo al 2023.

esempio.setUTCFullYear(2023);

Successivamente, visualizzo il risultato:

document.write(esempio.toUTCString());

Dato che il 29 febbraio 2023 non esiste, la data corretta sarà il 1° marzo 2023.

Fri, 01 Mar 2023 12:00:00 GMT