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 entsprechend 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, und so weiter.
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 seinen neuen Zeitstempel zurück. Wenn ein Parameter NaN ist (oder andere Werte, die auf NaN gezwungen werden, wie undefined), wird das Datum auf Invalid Date gesetzt und NaN wird zurückgegeben.
Beschreibung
Wenn Sie den Parameter dateValue 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. Beispielsweise wird, wenn Sie 15 für monthValue verwenden, 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® 2025 Language Specification # sec-date.prototype.setutcmonth |