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 ost, ä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 Latest Draft (ECMA-262)
Die Definition von 'Date.prototype.setFullYear' in dieser Spezifikation.
Entwurf  

Browserkompatibilität

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Grundlegende Unterstützung Ja Ja1 Ja Ja Ja
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Grundlegende Unterstützung Ja Ja Ja4 Ja Ja Ja

Siehe auch

Schlagwörter des Dokuments und Mitwirkende

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