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.
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 6 (ECMA-262) The definition of 'Date.prototype.getYear' in that specification. |
Release Candidate | 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) |