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 setUTCMonth()-Methode 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-
Ein ganzzahliger Wert, der den Monat repräsentiert: 0 für Januar, 1 für Februar usw.
dateValueOptional-
Ein ganzzahliger Wert von 1 bis 31, der den Tag des Monats repräsentiert.
Rückgabewert
Ändert das Date-Objekt vor Ort und gibt dessen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist (oder andere Werte, die zu NaN erzwungen werden wie undefined), wird das Datum auf Invalid Date gesetzt und NaN wird zurückgegeben.
Beschreibung
Falls Sie den dateValue-Parameter nicht angeben, wird der Wert, der von der
getUTCDate()-Methode zurückgegeben wird, verwendet.
Wenn ein von Ihnen angegebener Parameter außerhalb des erwarteten Bereichs liegt, versucht setUTCMonth(), die Datumsinformationen im Date-Objekt entsprechend zu aktualisieren. Zum Beispiel, wenn Sie 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 |