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

js
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()

js
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 GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
setUTCDate

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch