Date.prototype.getYear()

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

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

Syntax

js
getYear()

Parameter

Keine.

Rückgabewert

Eine Ganzzahl, die das Jahr für das gegebene Datum gemäß der lokalen Zeit minus 1900 repräsentiert. Gibt NaN zurück, wenn das Datum ungültig ist.

  • Für Jahre größer oder gleich 2000 ist der Wert 100 oder größer. Zum Beispiel, wenn das Jahr 2026 ist, gibt getYear() 126 zurück.
  • Für Jahre zwischen 1900 und 1999 (einschließlich) liegt 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® 2026 Language Specification
# sec-date.prototype.getyear

Browser-Kompatibilität

Siehe auch