Unerwünscht
Dieses Feature wurde aus den Webstandards entfernt. Obwohl manche Browser es immer noch unterstützen, wird es zukünftig wegfallen. Es sollte daher nicht mehr in alten oder neuen Projekten verwendet werden. Webseiten oder Webapps, die es benutzen, funktionieren möglicherweise irgendwann nicht mehr korrekt.
Die getYear()
Methode gibt das Jahr eines Datums bezüglich der Ortszeit zurück. Weil getYear()
nicht das ganze Jahr zurück gibt (das "Jahr 2000 Problem"), wird es nicht weiter eingesetzt und wird von der Methode getFullYear()
ersetzt.
Syntax
dateObj.getYear()
Rückgabewert
Eine Zahl, welche das Jahr minus 1900 des gegebenen Datums bezüglich der lokalen Zeit angibt.
Beschreibung
- Für Jahre größer oder gleich 2000 ist der Rückgabewert von
getYear()
100 oder größer. Zum Beispiel wird für das Jahr 2026 der Wert 126 zurück gegeben. - Für Jahre zwischen 1900 und 1999 ist der Rückgabewert von
getYear()
zwischen 0 und 99. Zum Beispiel wird für das Jahr 1976 der Wert 76 zurückgegeben. - Für Jahre kleiner als 1900 ist der Rückgabewert von
getYear()
kleiner 0. Zum Beispiel wird für das Jahr 1800 der Wert -100 zurück gegeben.
Um mit Jahren vor und nach 2000 umgehen zu können, sollte stattdessen die Methode getFullYear()
eingesetzt werden. Diese gibt das vollständige Jahr zurück.
Rückwärtskompatibilität
Verhalten in JavaScript 1.2 und früher
Die getYear()
Methode gibt entweder ein 2-stelliges oder 4-stelliges Jahr zurück.
- Für Jahre zwischen 1900 (inklusiv) und 1999 (inklusiv) gibt
getYear()
das Jahr minus 1900 zurück. Zum Beispiel wird für das Jahr 1976 der Wert 76 zurückgegeben. - Für Jahre kleiner als 1900 oder größer als 1999 gibt die
getYear()
eine 4-stellige Jahreszahl zurück. Zum Beispiel wird für das Jahr 1856 der Wert 1856 zurückgegeben. Für das Jahr 2016 wird der Wert 2026 zurückgegeben.
Beispiele
Jahre zwischen 1900 und 1999
Das zweite Statement initialisiert die Variable year
mit dem Wert 95.
var Xmas = new Date('December 25, 1995 23:15:00'); var year = Xmas.getYear(); // returns 95
Jahre nach 1999
Das zweite Statement initialisiert die Variable year
mit dem Wert 100.
var Xmas = new Date('December 25, 2000 23:15:00'); var year = Xmas.getYear(); // returns 100
Jahre vor 1900
Das zweite Statement initialisiert die Variable year
mit dem Wert -100.
var Xmas = new Date('December 25, 1800 23:15:00'); var year = Xmas.getYear(); // returns -100
Setzen und bekommen von Jahren zwischen 1900 und 1999
Das zweite Statement initialisiert die Variable year
mit dem Wert 95, was für das Jahr 1995 steht.
var Xmas = new Date('December 25, 2015 23:15:00'); Xmas.setYear(95); var year = Xmas.getYear(); // returns 95
Spezifikationen
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initiale Definition. Implementiert in JavaScript 1.3. |
ECMAScript 5.1 (ECMA-262) Die Definition von 'Date.prototype.getYear' in dieser Spezifikation. |
Standard |
Definiert in dem (informativen) Kompatibilitäts-Anhang |
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Date.prototype.getYear' in dieser Spezifikation. |
Standard | Definiert in dem (normativ) Anhang für zusätzliche Funktionen für Web-Browser. |
ECMAScript 2017 Draft (ECMA-262) Die Definition von 'Date.prototype.getYear' in dieser Spezifikation. |
Entwurf |
Browserkompatibilität
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |