Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Date.prototype.getFullYear: anno locale completo

getFullYear restituisce il numero completo dell’anno calcolato in ora locale, senza il vecchio offset 1900.

Versione: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintassi

date.getFullYear()

date.getFullYear() restituisce l’anno locale come Number, per esempio 2024. Diversamente dal deprecato getYear(), non sottrae 1900. Il fuso conta vicino al cambio d’anno; per l’anno UTC usa getUTCFullYear(). L’anno 0 e gli anni negativi sono ammessi dal modello temporale ECMAScript.

Il metodo non accetta argomenti, non modifica la data e ignora quelli aggiuntivi. Restituisce NaN per un Date non valido. Un receiver senza stato interno Date, come Date.prototype.getFullYear.call({}), genera TypeError.

Usalo per raggruppare o mostrare un anno locale, ricordando che un anno senza mese, giorno e fuso non identifica un istante. Il metodo esiste da ECMAScript 1.

Esempi

const date = new Date(1999, 11, 31, 12);
console.log(date.getFullYear());

date.setFullYear(2000);
console.log(date.getFullYear(), date.getMonth(), date.getDate());
console.log(Number.isNaN(new Date(NaN).getFullYear()));

Risultato

1999
2000 11 31
true

Fonti