Date.prototype.setUTCFullYear()

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

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

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

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Siehe auch

• Date.prototype.getUTCFullYear()
• Date.prototype.setFullYear()