Il metodo setUTCMilliseconds() di Javascript

Il metodo setUTCMilliseconds() mi permette di impostare i millisecondi, secondo il tempo universale coordinato (UTC) in una data specifica di un oggetto nel linguaggio Javascript.

oggetto.setUTCMilliseconds(millisecondsValue)

Qui, l'oggetto è un'istanza dell'oggetto Date e l'argomento millisecondsValue tra le parentesi tonde è un numero intero che rappresenta i millisecondi.

Se il valore di millisecondsValue supera 999, poiché un secondo ha 1000 millisecondi, il metodo setUTCMilliseconds() incrementa automaticamente i secondi.

Questo metodo apporta modifiche dirette all'oggetto Date basandosi sull'orario UTC, pertanto non considera i fusi orari locali. Per lavorare con date e orari locali, bisogna fare riferimento al metodo setMilliseconds() invece di setUTCMilliseconds().

Ad esempio, supponiamo di avere un oggetto Date impostato alla seguente data e ora: 16 ottobre 2023 alle 12:00:00.

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

Successivamente, utilizzo il metodo setUTCMilliseconds() per impostare 500 millisecondi:

esempio.setUTCMilliseconds(500);

Dopodiché, visualizzo il contenuto dell'oggetto che ho aggiornato.

document.write(esempio.toUTCString());

L'output è la stessa data ma con 500 millisecondi anziché zero.

Tue, 16 Oct 2023 12:00:00.500 GMT

Esempio 2

Se specifico un valore di millisecondi che supera 999, il metodo incrementa i secondi di conseguenza.

Ad esempio, prendo ancora l'oggetto Date impostato al 16 ottobre 2023 alle 12:00:00.

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

Stavolta, imposto 1500 millisecondi.

esempio.setUTCMilliseconds(1500);

E visualizzo l'orario aggiornato.

document.write(esempio.toUTCString());

Dato che ho aggiunto 1500 millisecondi, l'output è lo stesso orario precedente ma incrementato di 1 secondo e 500 millisecondi.

Tue, 16 Oct 2023 12:00:01.500 GMT

E così via.