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.
Resum
El mètode getYear()
retorna l'any de la data especificada segons l'hora local. Com que getYear()
no retorna anys sencers ("el problema de l'any 2000"), no s'utilitza més i s'ha substituït pel mètode getFullYear()
.
Sintaxi
dateObj.getYear()
Paràmetres
Cap.
Retorna
El mètode getYear()
retorna l'any menys el valor 1900; és a dir:
- Per a anys majors o iguals a 2000, el valor retornat per
getYear()
és 100 o major. Per exemple, si l'any és el 2026,getYear()
retorna 126. - Per a anys entre 1900 i 1999 (ambdós inclosos), el valor retornat per
getYear()
roman entre 0 i 99. Per exemple, per a l'any 1976getYear()
retorna 76. - Per a anys menors que 1900, el valor retornat per
getYear()
és menor que zero. Per exemple, per a l'any 1800,getYear()
retorna -100.
Per a tenir en compte anys abans o deprés del 2000 es recomana utilitzar getFullYear()
en comptes de getYear()
ja que retorna l'any sencer.
Compatibilitat amb versions anteriors
Comportament en JavaScript 1.2 i anteriors
El mètode getYear()
retorna o bé un any amb dos dígits o bé un any amb 4 dígits:
- Per a anys entre 1900 i 1999 (ambdos inclosos) el valor retornat és l'any menys 1900. Per exemple, per a l'any 1976 el valor retornat és 76.
- Per a anys menors que 1900 o majors que 1999 el valor retornat per
getYear()
és l'any amb 4 dígits. Per exemple, per a l'any 1856 el valor retornat és 1856. Per a l'any 2026 el valor retornat és 2026.
Exemples
Exemple: Anys entre1900 i 1999
La segona sentència assigna el valor 95 a la variable any
.
var nadal = new Date('December 25, 1995 23:15:00');
var any = nadal.getYear(); // retorna 95
Exemple: Anys majors que 1999
La segona sentència assigna el valor 100 a la variable any
.
var nadal = new Date('December 25, 2000 23:15:00');
var any = Xmas.getYear(); // retorna 100
Exemple: Anys menors que 1900
La segona sentència assigna el valor -100 a la variable any
.
var nadal = new Date('December 25, 1800 23:15:00');
var any = nadal.getYear(); // retorna -100
Exemple: Assignar i obtenir un any entre1900 i 1999
La segona sentència assigna el valor 95 a la variable any
, que representa l'any 1995.
var nadal.setYear(95);
var any = nadal.getYear(); // retorna 95
Especificacions
Especificació | Estat | Comentaris |
---|---|---|
ECMAScript 1a Edició. | Standard | Definició inicial. Implementat a JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) The definition of 'Date.prototype.getYear' in that specification. |
Standard | Definit a l'annex de compatibilitat (amb caràcter informatiu). |
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'Date.prototype.getYear' in that specification. |
Standard | Definit a l'annex de característiques adicionals per a navegadors web (amb caràcter normatiu). |
Compatibilitat amb navegadors
Característica | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Suport bàsic | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |
Característica | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Suport bàsic | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) | (Yes) |