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

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 setDate() von Date-Instanzen ändert den Tag des Monats für dieses Datum gemäß der Ortszeit.

Probieren Sie es aus

const event = new Date("August 19, 1975 23:15:30");

event.setDate(24);

console.log(event.getDate());
// Expected output: 24

event.setDate(32);
// Only 31 days in August!

console.log(event.getDate());
// Expected output: 1

Syntax

js
setDate(dateValue)

Parameter

dateValue

Eine Ganzzahl, 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 zu NaN konvertiert wird, etwa undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.

Beschreibung

Wenn Sie eine Zahl außerhalb des erwarteten Bereichs angeben, werden die Datumsangaben im Date-Objekt entsprechend aktualisiert. Enthält das Date-Objekt beispielsweise den 1. Juni, ändert ein dateValue von 40 das Datum auf den 10. Juli, während ein dateValue von 0 es auf den letzten Tag des Vormonats, den 31. Mai, ändert.

Da setDate() mit der Ortszeit arbeitet, kann das Überschreiten einer Grenze zwischen Sommer- und Normalzeit zu einer anderen verstrichenen Zeit führen als erwartet. Wenn beim Setzen des Datums beispielsweise auf Sommerzeit umgestellt wird (wobei eine Stunde entfällt), ist die Differenz zwischen dem neuen und dem alten Zeitstempel eine Stunde geringer als die nominelle Anzahl der Tage multipliziert mit 24 Stunden. Bei der Umstellung auf Normalzeit (wobei eine Stunde hinzukommt) ergibt sich dagegen eine zusätzliche Stunde. Wenn Sie das Datum um eine feste Zeitspanne ändern müssen, sollten Sie setUTCDate() oder setTime() verwenden.

Wenn die neue Ortszeit in einen Zeitzonenübergang fällt, wird der genaue Zeitpunkt nach demselben Verhalten bestimmt wie bei der Option disambiguation: "compatible" von Temporal. Das heißt: Entspricht die Ortszeit zwei Zeitpunkten, wird der frühere gewählt. Existiert die Ortszeit nicht (weil eine Lücke besteht), wird sie um die Dauer der Lücke nach vorn verschoben.

Beispiele

Verwendung von setDate()

js
const theBigDay = new Date(1962, 6, 7, 12); // noon of 1962-07-07 (7th of July 1962, month is 0-indexed)
const theBigDay2 = new Date(theBigDay).setDate(24); // 1962-07-24 (24th of July 1962)
const theBigDay3 = new Date(theBigDay).setDate(32); // 1962-08-01 (1st of August 1962)
const theBigDay4 = new Date(theBigDay).setDate(22); // 1962-07-22 (22nd of July 1962)
const theBigDay5 = new Date(theBigDay).setDate(0); // 1962-06-30 (30th of June 1962)
const theBigDay6 = new Date(theBigDay).setDate(98); // 1962-10-06 (6th of October 1962)
const theBigDay7 = new Date(theBigDay).setDate(-50); // 1962-05-11 (11th of May 1962)

Spezifikationen

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

Browser-Kompatibilität

Siehe auch