Date.prototype.setUTCFullYear()

Die setUTCFullYear() Methode setzt das volle Jahr für ein Datum bezüglich der Weltzeit.

Syntax

dateObj.setUTCFullYear(yearValue[, monthValue[, dayValue]])

Parameter

yearValue
Eine ganze Zahl, die das Jahr repräsentiert (z. B. 1995).
monthValue
Optional. Eine ganze Zahl zwischen 0 und 11, die die Monate Januar bis Dezember repräsentiert.
dayValue
Optional. Eine ganze Zahl zwischen 1 und 31, die den Tag eines Monats repräsentiert. Wenn dayValue benutzt wird, muss auch der Parameter monthValue benutzt werden.

Rückgabewert

Die Anzahl der Millisekunden zwischen dem 1. Januar 1970 00:00:00 UTC und dem aktualisierten date Objekte.

Beschreibung

Wenn die Parameter monthValue und dayValue nicht angegeben werden, so werden für diese die Rückgabewerte der Methoden getUTCMonth() und getUTCDate() benutzt.

Wenn ein Parameter außerhalb seiner spezifizierten Grenzen liegt, berücksichtigt die setUTCFullYear() Methode diese Information beim aktualisieren eines Date Objektes. Wenn zum Beispiel 15  für monthValue angegeben wird, so wird das Jahr um 1 inkrementiert (yearValue + 1) und der Monat wird auf 3 gesetzt.

Beispiele

Einsatz von setUTCFullYear()

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

Spezifikationen

Browserkompatibilität

BCD tables only load in the browser

Siehe auch