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 (UTC).

Probieren Sie es aus

Syntax

js
setUTCDate(dateValue)

Parameter

dateValue

Ein ganzzahliger Wert von 1 bis 31, der den Tag des Monats darstellt.

Rückgabewert

Ändert das Date Objekt vor Ort und gibt seinen neuen Zeitstempel zurück. Wenn dateValue NaN ist (oder andere Werte, die zu NaN umgewandelt werden, wie z.B. undefined), wird das Datum auf Ungültiges Datum gesetzt und NaN wird zurückgegeben.

Beschreibung

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

Zum Beispiel, 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, der im Date Objekt gespeichert ist, 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 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 Language Specification
# sec-date.prototype.setutcdate

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch