Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Date — timestamp e anno UTC

Date memorizza un timestamp. Scopri come leggere e modificare l’anno UTC, come funziona la mutazione dell’oggetto e come vengono normalizzate le date, incluso il passaggio dal 29 febbraio a un anno non bisestile.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

new Date(milliseconds)
new Date(isoString)
date.getUTCFullYear()
date.setUTCFullYear(year[, month[, day]])

Date è un oggetto integrato di ECMAScript che memorizza i millisecondi trascorsi da 1970-01-01T00:00:00.000Z, oppure NaN se la data non è valida. Non memorizza un fuso orario. I metodi locali interpretano lo stesso timestamp in base al fuso orario dell’ambiente; i metodi UTC usano UTC.

Date.prototype.getUTCFullYear() restituisce l’anno UTC completo, oppure NaN se la data non è valida. Date.prototype.setUTCFullYear(year[, month[, day]]) modifica l’oggetto e restituisce il timestamp risultante, non un oggetto Date. I mesi usano gli indici 0–11, mentre i giorni del mese partono da 1. Se la data originale è valida, per ogni argomento omesso relativo al mese o al giorno il metodo usa come dato di partenza il valore originale in UTC. La normalizzazione può cambiare il mese e il giorno nel risultato. Se il risultato è valido, l’ora in UTC rimane invariata.

Il setter normalizza i valori: cambiare l’anno del 29 febbraio impostandone uno non bisestile produce il 1° marzo. Un anno compreso tra 0–99 viene interpretato alla lettera, a differenza del costruttore Date con più argomenti. Per una data non valida, il setter usa il timestamp 0 come punto di partenza; gli argomenti numerici non validi possono comunque produrre NaN.

L’esempio usa una Z esplicita e metodi UTC, così il risultato non dipende dal fuso orario locale. Verifica anche che il timestamp restituito corrisponda all’oggetto modificato.

Esempi

const date = new Date("2024-02-29T12:00:00.000Z");
console.log(date.getUTCFullYear());
const timestamp = date.setUTCFullYear(2025);
console.log(date.toISOString());
console.log(timestamp === date.getTime());

Risultato

2024
2025-03-01T12:00:00.000Z
true

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti