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 ParametermonthValue
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
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.setUTCFullYear' in dieser Spezifikation. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Date.prototype.setUTCFullYear' in dieser Spezifikation. |
Standard | |
ECMAScript (ECMA-262) Die Definition von 'Date.prototype.setUTCFullYear' in dieser Spezifikation. |
Lebender Standard |
Browserkompatibilität
BCD tables only load in the browser
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.