Date.prototype.getYear()

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)

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

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