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 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 2017 Draft (ECMA-262) Die Definition von 'Date.prototype.setUTCFullYear' in dieser Spezifikation. |
Entwurf |
Browserkompatibilität
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) | (Ja) |
Siehe auch
Schlagwörter des Dokuments und Mitwirkende
Schlagwörter:
Mitwirkende an dieser Seite:
schlagi123
Zuletzt aktualisiert von:
schlagi123,