MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Deprecated
This feature has been removed from the Web standards. Though some browsers may still support it, it is in the process of being dropped. Do not use it in old or new projects. Pages or Web apps using it may break at any time.

Resumo

O método getYear() retorna o ano especificado pela data de acordo com a hora local. Por conta do fato de que getYear() não retorna anos completos ("problema do ano 2000"), este método não é mais utilizado e foi substituido pelo método getFullYear().

Sintaxe

dateObj.getYear()

Parâmetros

Nenhum.

Retorna

O método getYear() retorna o ano menos 1900; então:

  • Para ano maior ou igual a 2000, o valor retornado por getYear() é 100 ou mais. Por exemplo, se o ano for 2026, getYear() retorna 126.
  • Para ano entre e incluindo 1900 e 1999, o valor retornado por getYear() é entre 0 e 99. Por exemplo, se o anor for 1976, getYear() retorna 76.
  • Para ano menor que 1900, o valor retornado por getYear() é menor que 0. Por exemplo, se o ano for 1800, getYear() retorna -100.

Para levar em consideração anos antes e depois de 2000, você deve utilizar getFullYear() ao invés de getYear() para que o ano seja especificado por completo.

Retrocombatibilidade

Comportamento em JavaScript 1.2 e anteriores

O método getYear() retorna um ano de 2 ou 4 dígitos:

  • Para anos entre e incluindo 1900 e 1999, o valor retornado por getYear() é o ano menos 1900. Por exemplo, se o ano é 1976, o valor retornado é 76.
  • Para anos menores que 1900 ou maiores que 1999, o valor retornado por getYear() é um ano de 4 dígitos. Por exemplo, se o ano é 1856, o valor retornado é 1856. Se o ano é 2026, o valor retornado é 2026.

Exemplos

Exemplo: Anos entre 1900 e 1999

O segundo statement atribui o valor 95 à variável year.

var Xmas = new Date('December 25, 1995 23:15:00');
var year = Xmas.getYear(); // returns 95

Exemplo: Anos depois de 1999

O segundo statement atribui o valor 100 à variável year.

var Xmas = new Date('December 25, 2000 23:15:00');
var year = Xmas.getYear(); // returns 100

Exemplo: Anos antes de 1900

O segundo statement atribui o valor  -100 à variável year.

var Xmas = new Date('December 25, 1800 23:15:00');
var year = Xmas.getYear(); // returns -100

Exemplo: Setando e recuperando um ano entre 1900 e 1999

O segundo statement atribui o valor 95 à variável year, representanto o ano 1995.

var Xmas.setYear(95);
var year = Xmas.getYear(); // returns 95

Especificações

Especificação Status Comentário
ECMAScript 1st Edition. Standard Definição inicial. Implementado em JavaScript 1.3.
ECMAScript 5.1 (ECMA-262)
The definition of 'Date.prototype.getYear' in that specification.
Standard Definido em (informativo) compatibilidade annex.
ECMAScript 2015 (6th Edition, ECMA-262)
The definition of 'Date.prototype.getYear' in that specification.
Standard Definido em (normativo) annex para funcionalidades adicionais para futuros browsers web.

Compatibilidade com browsers

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Yes) (Yes) (Yes) (Yes) (Yes)
Feature Android Chrome for Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

Veja também

Etiquetas do documento e colaboradores

 Colaboradores desta página: thiagoh
 Última atualização por: thiagoh,