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 dieses Datums 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

js
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.

dateValue Optional

Eine ganze Zahl von 1 bis 31, die den Tag des Monats darstellt.

Rückgabewert

Ändert das Date-Objekt an Ort und Stelle und gibt dessen neuen Zeitstempel zurück. Falls ein Parameter NaN ist (oder andere Werte, die erzwungen werden, wie z. B. undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.

Beschreibung

Falls der Parameter dateValue nicht angegeben wird, wird der Wert der getUTCDate()-Methode verwendet.

Falls ein 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 wird als Monat verwendet.

Beispiele

Verwendung von setUTCMonth()

js
const theBigDay = new Date();
theBigDay.setUTCMonth(11);

Spezifikationen

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.setutcmonth

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch