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 Methode setUTCDate() von Date Instanzen ändert den Tag des Monats für dieses Datum entsprechend der koordinierten 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: Eine ganze Zahl zwischen 1 und 31, die den Tag des Monats repräsentiert.

Ändert das Date-Objekt direkt und gibt dessen neuen Zeitstempel 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 wird zurückgegeben.

Beschreibung

Wenn 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 angegeben ist, 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 aus gezählt. -1 würde dazu führen, dass das Datum auf 1 Tag vor dem letzten Tag des vorherigen Monats eingestellt wird.

Beispiele

Verwendung von setUTCDate()

const theBigDay = new Date();
theBigDay.setUTCDate(20);

Spezifikationen

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