Date.prototype.setUTCDate()
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 setUTCDate()
-Methode von Date
-Instanzen ändert den Tag des Monats für dieses Datum basierend auf der universellen Zeit.
Probieren Sie es aus
const event = new Date("August 19, 1975 23:15:30 GMT-3:00");
console.log(event.getUTCDate());
// Expected output: 20
event.setUTCDate(19);
console.log(event.getUTCDate());
// Expected output: 19
Syntax
setUTCDate(dateValue)
Parameter
dateValue
-
Eine Ganzzahl von 1 bis 31, die den Tag des Monats darstellt.
Rückgabewert
Ändert das Date
-Objekt direkt und gibt seinen neuen Zeitstempel zurück. Wenn dateValue
NaN
ist (oder andere Werte, die zu NaN
umgewandelt werden, wie undefined
), wird das Datum auf Invalid Date gesetzt und es wird NaN
zurückgegeben.
Beschreibung
Wenn der dateValue
außerhalb des Bereichs der Datumswerte für den Monat liegt, aktualisiert setDate()
das Date
-Objekt entsprechend.
Zum Beispiel wird das Datum, wenn für dateValue
der Wert 0 angegeben wird, auf den letzten Tag des vorherigen Monats gesetzt. Wenn Sie 40 für dateValue
verwenden und der im Date
-Objekt gespeicherte Monat Juni ist, wird der Tag auf den 10. geändert und der Monat auf Juli erhöht.
Wenn eine negative Zahl als dateValue
angegeben wird, wird das Datum rückwärts vom letzten Tag des vorherigen Monats gezählt. -1 würde dazu führen, dass das Datum auf einen Tag vor dem letzten Tag des vorherigen Monats gesetzt wird.
Beispiele
Verwendung von setUTCDate()
const theBigDay = new Date();
theBigDay.setUTCDate(20);
Spezifikationen
Specification |
---|
ECMAScript® 2025 Language Specification # sec-date.prototype.setutcdate |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
setUTCDate |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support