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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setUTCMonth

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch