Date.prototype.getYear()
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see the compatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work 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
Specification |
---|
ECMAScript Language Specification # sec-date.prototype.getyear |
Compatibilidade com navegadores
BCD tables only load in the browser