Date.prototype.setMonth()

Die setMonth() Methode setzt den Monat eines Datums bezüglich des aktuellen Jahres.

Syntax

dateObj.setMonth(monthValue[, dayValue])

Versionen vor JavaScript 1.3

dateObj.setMonth(monthValue)

Parameter

monthValue

Eine ganze Zahl zwischen 0 und 11, die die Monate Januar bis Dezember repräsentiert.

dayValue

Optional. Eine ganze Zahl zwischen 1 und 31, die die Tage eines Monats repräsentiert.

Rückgabewert

Die Anzahl der Millisekunden zwischen dem 1. Januar 1970 00:00:00 UTC und dem geänderten date Objekt.

Beschreibung

Wenn der dayValue Parameter nicht gesetzt wird, bekommt er den Rückgabewert der getDate() Methode.

Wenn ein Parameter mit einem Wert außerhalb seiner Grenzen übergebn wird, berücksichtigt die  setMonth() Methode diese Information in dem Date Objekt. Wird zum Beispiel der Wert 15 für den monthValue Parameter übergeben, so wird das Jahr um 1 inkrementiert und der Monat auf dem Wert 3 gesetzt.

Der aktuelle Tag des Monats hat einen Einfluss auf diese Methode. Konzeptionell wird die Anzahl der Tage des aktuellen Monats hinzugefügt, um zum 1. des neuen Monats zu bekommen. Wird zum Beispiel auf dem 31. August 2016 setMonth mit dem Wert 1 aufgerufen, so wird der 2. März 2016 zurückgegeben. Dieses liegt daran, dass der Februar im Jahr 2016 nur 29 Tage hat.

Beispiele

Einsatz von setMonth()

var theBigDay = new Date();
theBigDay.setMonth(6);

//Achtet auf die Übergänge am Ende des Monats
var endOfMonth = new Date(2016, 7, 31);
endOfMonth.setMonth(1);
console.log(endOfMonth); //Wed Mar 02 2016 00:00:00

Spezifikationen

Browserkompatibilität

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Siehe auch

• Date.prototype.getMonth()
• Date.prototype.setUTCMonth()