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
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()
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 GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setUTCMonth |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support