Date.prototype.getYear()

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Die getYear() Methode von Date Instanzen liefert das Jahr für dieses Datum gemäß der lokalen Zeit. Da getYear() keine vollständigen Jahre zurückgibt ("Jahr-2000-Problem"), ist es veraltet und wurde durch die getFullYear() Methode ersetzt.

Syntax

js
getYear()

Parameter

Keine.

Rückgabewert

Ein ganzzahliger Wert, der das Jahr für das gegebene Datum gemäß der lokalen Zeit minus 1900 darstellt. Gibt NaN zurück, wenn das Datum ungültig ist.

  • Für Jahre ab 2000 ist der Wert 100 oder größer. Zum Beispiel, wenn das Jahr 2026 ist, gibt getYear() 126 zurück.
  • Für Jahre zwischen einschließlich 1900 und 1999 ist der von getYear() zurückgegebene Wert zwischen 0 und 99. Zum Beispiel, wenn das Jahr 1976 ist, gibt getYear() 76 zurück.
  • Für Jahre kleiner als 1900 ist der von getYear() zurückgegebene Wert kleiner als 0. Zum Beispiel, wenn das Jahr 1800 ist, gibt getYear() -100 zurück.

Diese Methode gibt im Wesentlichen den Wert von getFullYear() minus 1900 zurück. Sie sollten stattdessen getFullYear() verwenden, damit das Jahr vollständig angegeben wird.

Beispiele

Jahre zwischen 1900 und 1999

Die zweite Anweisung weist der Variablen year den Wert 95 zu.

js
const xmas = new Date("1995-12-25");
const year = xmas.getYear(); // returns 95

Jahre über 1999

Die zweite Anweisung weist der Variablen year den Wert 100 zu.

js
const xmas = new Date("2000-12-25");
const year = xmas.getYear(); // returns 100

Jahre unter 1900

Die zweite Anweisung weist der Variablen year den Wert -100 zu.

js
const xmas = new Date("1800-12-25");
const year = xmas.getYear(); // returns -100

Setzen und Abrufen eines Jahres zwischen 1900 und 1999

Die dritte Anweisung weist der Variablen year den Wert 95 zu, was das Jahr 1995 darstellt.

js
const xmas = new Date("2015-12-25");
xmas.setYear(95);
const year = xmas.getYear(); // returns 95

Spezifikationen

Specification
ECMAScript Language Specification
# sec-date.prototype.getyear

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch