CKTIS / JavaScript
Date.prototype.getFullYear: ano local completo
getFullYear devolve o número completo do ano calculado em hora local, sem o antigo deslocamento de 1900.
Versão: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaxe
date.getFullYear()date.getFullYear() devolve o ano local como Number, por exemplo 2024. Ao contrário do obsoleto getYear(), não subtrai 1900. O fuso importa perto da passagem de ano; para o ano UTC usa getUTCFullYear(). O ano 0 e anos negativos são permitidos pelo modelo temporal ECMAScript.
O método não recebe argumentos, não altera a data e ignora argumentos adicionais. Devolve NaN para um Date inválido. Um receiver sem estado interno Date, como Date.prototype.getFullYear.call({}), lança TypeError.
Usa-o para agrupar ou mostrar um ano local, lembrando que um ano sem mês, dia e fuso não identifica um instante. O método existe desde ECMAScript 1.
Exemplos
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