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

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 setMonth() von Date-Instanzen ändert den Monat und/oder 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.setMonth(3);

console.log(event.getMonth());
// Expected output: 3

console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:30 GMT+0100 (CET)"
// Note: your timezone may vary

Syntax

js
setMonth(monthValue)
setMonth(monthValue, dateValue)

Parameter

monthValue

Eine Ganzzahl, die den Monat angibt: 0 für Januar, 1 für Februar und so weiter.

dateValue Optional

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 ein Parameter NaN ist (oder ein anderer Wert, der in NaN umgewandelt wird, etwa undefined), wird das Datum auf Invalid Date gesetzt und NaN zurückgegeben.

Beschreibung

Wenn Sie den Parameter dateValue nicht angeben, wird derselbe Wert verwendet, den getDate() zurückgibt.

Wenn ein angegebener Parameter außerhalb des erwarteten Bereichs liegt, werden die anderen Parameter und die Datumsangaben im Date-Objekt entsprechend angepasst. Wenn Sie beispielsweise für monthValue den Wert 15 angeben, wird das Jahr um 1 erhöht und für den Monat der Wert 3 verwendet.

Der aktuelle Tag des Monats beeinflusst das Verhalten dieser Methode. Vereinfacht gesagt wird die Anzahl der Tage, die dem aktuellen Tag des Monats minus eins entspricht, zum ersten Tag des als Parameter angegebenen neuen Monats addiert. Daraus ergibt sich das neue Datum. Wenn das aktuelle Datum beispielsweise der 31. Januar 2016 ist, ergibt ein Aufruf von setMonth() mit dem Wert 1 den 2. März 2016. Das liegt daran, dass der Februar 2016 29 Tage hatte.

Da setMonth() mit der Ortszeit arbeitet, kann beim Überschreiten einer Zeitumstellung die verstrichene Zeit vom erwarteten Wert abweichen. Wenn durch das Setzen des Monats beispielsweise eine Umstellung auf die Sommerzeit überschritten wird (bei der eine Stunde entfällt), ist die Differenz zwischen den Zeitstempeln des neuen und des alten Datums um eine Stunde geringer als die rechnerische Differenz in Tagen multipliziert mit 24 Stunden. Umgekehrt ergibt sich beim Überschreiten einer Umstellung zurück auf die Normalzeit (bei der eine Stunde hinzukommt) eine zusätzliche Stunde. Wenn Sie das Datum um eine feste Zeitspanne verschieben müssen, sollten Sie setUTCMonth() oder setTime() verwenden.

Wenn die neue Ortszeit in eine Zeitumstellung fällt, wird der genaue Zeitpunkt nach demselben Verfahren bestimmt wie bei der Option disambiguation: "compatible" von Temporal: Entspricht die Ortszeit zwei Zeitpunkten, wird der frühere gewählt. Existiert die Ortszeit nicht, weil eine Lücke entsteht, wird die Uhrzeit um die Dauer der Lücke vorwärts verschoben.

Beispiele

setMonth() verwenden

js
const theBigDay = new Date();
theBigDay.setMonth(6);

// Watch out for end of month transitions
const endOfMonth = new Date(2016, 7, 31);
endOfMonth.setMonth(1);
console.log(endOfMonth); // Wed Mar 02 2016 00:00:00

Spezifikationen

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

Browser-Kompatibilität

Siehe auch