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 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: Ein Ganzzahlwert von 1 bis 31, der den Tag des Monats darstellt.

Ändert das Date-Objekt direkt und gibt dessen neuen Zeitstempel zurück. Wenn dateValue NaN ist (oder andere Werte, die auf NaN umgewandelt werden, wie undefined), wird das Datum auf Invalid Date gesetzt und NaN wird zurückgegeben.

Beschreibung

Wenn der dateValue außerhalb des Bereichs der Datumswerte für den Monat liegt, wird setDate() das Date-Objekt entsprechend aktualisieren.

Beispielsweise, wenn 0 für dateValue angegeben wird, wird das Datum auf den letzten Tag des vorherigen Monats gesetzt. Wenn Sie 40 für dateValue verwenden und der Monat im Date-Objekt Juni ist, wird der Tag auf den 10. geändert und der Monat wird auf Juli erhöht.

Wenn eine negative Zahl für dateValue angegeben wird, wird das Datum vom letzten Tag des vorherigen Monats rückwärts 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