Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes