Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

Date.prototype.setUTCDate()

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die Methode setUTCDate() von Date-Instanzen ändert den Tag des Monats für dieses Datum nach 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

js
setUTCDate(dateValue)

Parameter

dateValue

Eine Ganzzahl von 1 bis 31, die den Tag des Monats angibt.

Rückgabewert

Ändert das Date-Objekt direkt und gibt seinen neuen Zeitstempel zurück. Wenn dateValue NaN ist (oder ein anderer Wert, der wie undefined in NaN umgewandelt wird), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.

Beschreibung

Wenn dateValue außerhalb des gültigen Bereichs für die Tage des Monats liegt, aktualisiert setUTCDate() das Date-Objekt entsprechend.

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

Wird für dateValue eine negative Zahl übergeben, wird das Datum vom letzten Tag des vorherigen Monats aus rückwärts berechnet. Bei -1 wird das Datum auf einen Tag vor dem letzten Tag des vorherigen Monats gesetzt.

Beispiele

Verwendung von setUTCDate()

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

Spezifikationen

Spezifikation
ECMAScript® 2027 Language Specification
# sec-date.prototype.setutcdate

Browser-Kompatibilität

Siehe auch