Date.prototype.setUTCDate()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Die setUTCDate() Methode von Date Instanzen ändert den Tag des Monats für dieses Datum gemäß der Weltzeit.
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-
Ein Integer von 1 bis 31, der den Tag des Monats darstellt.
Rückgabewert
Ändert das Date Objekt an Ort und Stelle und gibt den neuen timestamp zurück. Wenn dateValue NaN ist (oder andere Werte, die zu NaN konvertiert werden, wie undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.
Beschreibung
Wenn der dateValue außerhalb des Bereichs der Datumswerte für den Monat liegt, wird setDate() das Date Objekt entsprechend aktualisieren.
Zum Beispiel, wenn 0 für dateValue übergeben wird, wird das Datum 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 für 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 1 Tag vor dem letzten Tag des vorherigen Monats gesetzt wird.
Beispiele
Verwendung von setUTCDate()
const theBigDay = new Date();
theBigDay.setUTCDate(20);
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2026 Language Specification # sec-date.prototype.setutcdate |