Il metodo setUTCHours() di Javascript

Il metodo setUTCHours() appartiene all'oggetto Date di JavaScript, mi consente di stabilire l'ora, rispetto al tempo universale coordinato (UTC) per una data definita.

oggetto.setUTCHours(hourValue)

Qui, "oggetto" fa riferimento a un'istanza dell'oggetto Date, mentre l'argomento hourValue tra le parentesi indica un valore intero rappresentante l'ora.

Se il valore hourValue supera 23 (poiché ci sono 24 ore in un giorno), il metodo setUTCHours() incrementa automaticamente il giorno.

Questo metodo aggiusta direttamente l'istanza dell'oggetto Date basandosi sull'orario UTC, ignorando gli eventuali fusi orari locali. Se si desidera interagire con le date e le ore locali, è consigliabile usare il metodo setHours() anziché setUTCHours().

Un esempio concreto: supponiamo di definire un oggetto Date fissando come data e ora 16 ottobre alle 12:00.

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

Successivamente, utilizzo il metodo setUTCHours() per cambiare l'ora, impostandola alle 20.

esempio.setUTCHours(20);

Poi, visualizzo il contenuto dell'oggetto:

document.write(esempio.toUTCString());

La data e l'ora registrate nell'oggetto ora sono le 20:00 del 16 ottobre.

Fri, 16 Oct 2023 20:00:00 GMT

Esempio 2

Se indico un'ora che supera le 23, il metodo sposterà automaticamente al giorno seguente.

Ridefinisco un oggetto Date fissandolo nuovamente al 16 ottobre alle 12:00.

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

Modifico poi l'ora nell'oggetto usando setUTCHours(), impostandola a 27.

esempio.setUTCHours(27);

Visualizzo infine il contenuto dell'oggetto:

document.write(esempio.toUTCString());

Considerando che un giorno ha 24 ore, l'ora aggiunta porta il conteggio al giorno successivo.

Ecco perché l'orario e la data nell'oggetto indicano le 3:00 del 17 ottobre.

Fri, 17 Oct 2023 03:00:00 GMT