Date.prototype.setUTCMonth()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Die Methode setUTCMonth() von Date-Instanzen ändert den Monat und/oder den Tag des Monats für dieses Datum gemäß der Weltzeit.
Probieren Sie es aus
const event = new Date("December 31, 1975 23:15:30 GMT-3:00");
console.log(event.toUTCString());
// Expected output: "Thu, 01 Jan 1976 02:15:30 GMT"
console.log(event.getUTCMonth());
// Expected output: 0
event.setUTCMonth(11);
console.log(event.toUTCString());
// Expected output: "Wed, 01 Dec 1976 02:15:30 GMT"
Syntax
setUTCMonth(monthValue)
setUTCMonth(monthValue, dateValue)
Parameter
monthValue-
Eine ganze Zahl, die den Monat darstellt: 0 für Januar, 1 für Februar und so weiter.
dateValueOptional-
Eine ganze Zahl von 1 bis 31, die den Tag des Monats darstellt.
Rückgabewert
Ändert das Date-Objekt und gibt seinen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist (oder andere Werte, die zu NaN koerziert werden, wie undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.
Beschreibung
Wenn Sie den dateValue-Parameter nicht angeben, wird der Wert verwendet, der von der getUTCDate()-Methode zurückgegeben wird.
Wenn ein angegebener Parameter außerhalb des erwarteten Bereichs liegt, versucht setUTCMonth(), die Datumsinformationen im Date-Objekt entsprechend zu aktualisieren. Wenn Sie zum Beispiel 15 für monthValue verwenden, wird das Jahr um 1 erhöht und 3 für den Monat verwendet.
Beispiele
Verwendung von setUTCMonth()
const theBigDay = new Date();
theBigDay.setUTCMonth(11);
Spezifikationen
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setutcmonth |