CKTIS / JavaScript
Date.prototype.getFullYear: año local completo
getFullYear devuelve el número completo del año calculado en hora local, sin el antiguo desplazamiento de 1900.
Versión: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaxis
date.getFullYear()date.getFullYear() devuelve el año local como Number, por ejemplo 2024. A diferencia del obsoleto getYear(), no resta 1900. La zona horaria importa cerca del cambio de año; para el año UTC usa getUTCFullYear(). El año 0 y los años negativos están permitidos en el modelo temporal ECMAScript.
El método no recibe argumentos, no modifica la fecha e ignora argumentos adicionales. Devuelve NaN para un Date inválido. Un receptor sin estado interno Date, como Date.prototype.getFullYear.call({}), lanza TypeError.
Úsalo para agrupar o mostrar un año local, recordando que un año sin mes, día y zona no identifica un instante. El método existe desde ECMAScript 1.
Ejemplos
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()));Resultado
1999 2000 11 31 true