Die setMonth()
Methode setzt den Monat eines Datums bezüglich des aktuellen Jahres.
The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.
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
Spezifikation | Status | Kommentar |
---|---|---|
ECMAScript 1st Edition (ECMA-262) | Standard | Initiale Definition. Implementiert in JavaScript 1.0. |
ECMAScript 5.1 (ECMA-262) Die Definition von 'Date.prototype.setMonth' in dieser Spezifikation. |
Standard | |
ECMAScript 2015 (6th Edition, ECMA-262) Die Definition von 'Date.prototype.setMonth' in dieser Spezifikation. |
Standard | |
ECMAScript (ECMA-262) Die Definition von 'Date.prototype.setMonth' in dieser Spezifikation. |
Lebender Standard |
Browserkompatibilität
BCD tables only load in the browser
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.