Date.prototype.setFullYear()

Die setFullYear() Methode stellt das ganze Jahr eines Datums bezüglich der Ortszeit ein und gibt einen neuen Zeitstempel zurück.

Syntax

dateObj.setFullYear(yearValue[, monthValue[, dateValue]])

Parameter

yearValue
Eine ganze Zahl, welche den nummerischen Wert des Jahres angibt (z. B. 1995).
monthValue
Optional. Eine ganze Zahl zwischen 0 und 11, welche den Monat von Januar bis Dezember angibt.
dateValue
Optional. Eine ganze Zahl zwischen 1 und 31, welche den Tag des Monats angibt. Wenn der dateValue Parameter angegeben wird, muss auch der monthValue Parameter angegeben werden.

Rückgabewert

Die Anzahl der Millisekunden zwischen dem 1. Januar 1970 00:00:00 UTC und dem geänderten date Objekt.

Beschreibung

Wenn die Parameter monthValue und dateValue nicht gesetzt sind, werden die Rückgabewerte der Methoden getMonth() und getDate() eingesetzt.

Wenn ein gesetzter Parameter außerhalb seiner erwarteten Grenzen ist, ändert setFullYear() entsprechenden die anderen Parameter und die Informationen im Date Objekt. Wird zum Beispiel 15 für monthValue Übergeben, so wird das Jahr um 1 inkrementiert und der Wert 3 wird für den Monat genutzt.

Beispiele

Einsatz von setFullYear()

var theBigDay = new Date();
theBigDay.setFullYear(1997);

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.setFullYear' in dieser Spezifikation.
Standard
ECMAScript 2015 (6th Edition, ECMA-262)
Die Definition von 'Date.prototype.setFullYear' in dieser Spezifikation.
Standard
ECMAScript (ECMA-262)
Die Definition von 'Date.prototype.setFullYear' in dieser Spezifikation.
Lebender Standard

Browserkompatibilität

BCD tables only load in the browser

Siehe auch