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

Ä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

Specification
ECMAScript® 2026 Language Specification # sec-date.prototype.setutcdate