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 Latest Draft (ECMA-262)
Die Definition von 'Date.prototype.getYear' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

Update compatibility data on GitHub
DesktopMobileServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid WebviewChrome für AndroidEdge MobileFirefox für AndroidOpera für AndroidiOS SafariSamsung InternetNode.js
Grundlegende Unterstützung
Veraltet
Chrome Vollständige Unterstützung JaEdge Vollständige Unterstützung JaFirefox Vollständige Unterstützung 1IE Vollständige Unterstützung JaOpera Vollständige Unterstützung JaSafari Vollständige Unterstützung JaWebView Android Vollständige Unterstützung JaChrome Android Vollständige Unterstützung JaEdge Mobile Vollständige Unterstützung JaFirefox Android Vollständige Unterstützung 4Opera Android Vollständige Unterstützung JaSafari iOS Vollständige Unterstützung JaSamsung Internet Android Vollständige Unterstützung Janodejs Vollständige Unterstützung Ja

Legende

Vollständige Unterstützung  
Vollständige Unterstützung
Veraltet. Nicht für den Einsatz in neuen Webseiten gedacht.
Veraltet. Nicht für den Einsatz in neuen Webseiten gedacht.

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

Mitwirkende an dieser Seite: schlagi123
Zuletzt aktualisiert von: schlagi123,