Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Date.prototype.getFullYear()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

Resumo

O método getFullYear() retorna o ano da data especificada de acordo com a hora local.

Use este método ao invés do getYear().

Sintaxe

dateObj.getFullYear()

Parâmetros

Nenhum.

Retorna

O valor retornado por getFullYear() é um número absoluto. Para datas entre os anos 1000 e 9999, getFullYear() retorna um número de quatro dígitos, por exemplo, 1995. Use esta função para ter certeza de que o ano é compatível com os anos depois de 2000.

Exemplos

Exemplo: Usando getFullYear()

O exemplo seguinte atribui o valor de quatro dígitos do ano corrente à variável year.

js
var today = new Date();
var year = today.getFullYear();

Especificações

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.getfullyear

Compatibilidade com navegadores

Veja também