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 für dieses Datum gemäß der Ortszeit zurück. Da getYear() keine vollständigen Jahre zurückgibt (das "Jahr 2000 Problem"), ist sie veraltet und wurde durch die getFullYear() Methode ersetzt.

Syntax

js
getYear()

Parameter

Keine.

Rückgabewert

Ein ganzzahliger Wert, der das Jahr für das angegebene Datum gemäß der Ortszeit darstellt, minus 1900. 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. Wenn das Jahr beispielsweise 2026 ist, gibt getYear() 126 zurück.
  • Für Jahre zwischen einschließlich 1900 und 1999 liegt der von getYear() zurückgegebene Wert zwischen 0 und 99. Wenn das Jahr beispielsweise 1976 ist, gibt getYear() 76 zurück.
  • Für Jahre kleiner als 1900 ist der von getYear() zurückgegebene Wert kleiner als 0. Wenn das Jahr beispielsweise 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 ist.

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

Einstellen und Abfragen 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® 2025 Language Specification
# sec-date.prototype.getyear

Browser-Kompatibilität

Siehe auch