Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes