JavaScript метод Date.setMonth()

Определение и применение

JavaScript метод setMonth() объекта Date устанавливает месяц для указанной даты по местному времени. Метод возвращает количество миллисекунд между 1 января 1970 00:00: 00 UTC и обновленной датой.

Поддержка браузерами

Метод	Chrome	Firefox	Opera	Safari	IExplorer	Edge
setMonth()	Да	Да	Да	Да	Да	Да

JavaScript синтаксис:

dateObj.setMonth(monthValue);
dateObj.setMonth(monthValue, dayValue);

monthValue - Integer
dayValue - Integer

Спецификация

Значения параметров

Если параметр dayValue не указан, то будет использовано значение возвращаемое методом getDate(). Если указанный параметр находится за пределами ожидаемого диапазона, то метод setMonth() пытается соответствующим образом обновить другие параметры и информацию о дате в объекте Date. Например, если вы используете 14 для monthValue, то год будет увеличен на 1, а 2 будет использоваться для месяца. По аналогии произойдет и с днем месяца, если его значение превысит количество дней в текущем месяце, то будет добавлено необходимое количество дней к следующему месяцу.

Пример использования

let someDay = new Date("February 14, 2019 12:00:00"); // создаем объект Date (передаем строковый аргумент, определяющий дату)
console.log(someDay); // Thu Feb 14 2019 12:00:00 GMT+0300 (Москва, стандартное время)

!!! вызовы в примере происходят к первоначальному значению, а не поочередно

someDay.setMonth(7); // устанавливаем месяц для указанной даты по местному времени
console.log(someDay); // Wed Aug 14 2019 12:00:00 GMT+0300 (Москва, стандартное время)

someDay.setMonth(7, 30); // устанавливаем месяц и день для указанной даты по местному времени
console.log(someDay); // Fri Aug 30 2019 12:00:00 GMT+0300 (Москва, стандартное время)

someDay.setMonth(10, 27); // устанавливаем месяц и день для указанной даты по местному времени
console.log(someDay); // Wed Nov 27 2019 12:00:00 GMT+0300 (Москва, стандартное время)

someDay.setMonth(11, 45); // устанавливаем месяц и день для указанной даты по местному времени
console.log(someDay); // Tue Jan 14 2020 12:00:00 GMT+0300 (Москва, стандартное время)