Date.prototype.setMonth()

Метод setMonth() экземпляров Date изменяет месяц и/или день месяца для этой даты в соответствии с местным временем.

Попробуйте

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

Синтаксис

setMonth(monthValue)
setMonth(monthValue, dateValue)

Параметры

monthValue

Целое число, представляющее месяц: 0 для января, 1 для февраля и так далее.

dateValue Необязательно

Целое число от 1 до 31, представляющее день месяца.

Возвращаемое значение

Изменяет объект Date на месте и возвращает его новую отметку времени. Если параметр имеет значение NaN (или другое значение, которое преобразуется в NaN, например undefined), дата устанавливается как Недопустимая дата (Invalid Date) и возвращается NaN.

Описание

Если вы не указываете параметр dateValue, используется то же значение, что возвращается функцией getDate().

Если указанный вами параметр выходит за пределы ожидаемого диапазона, другие параметры и информация о дате в объекте Date обновляются соответствующим образом. Например, если вы укажете 15 для monthValue, год увеличится на 1, а для месяца будет использовано значение 3.

Текущий день месяца будет влиять на поведение этого метода. Концептуально он прибавляет количество дней, заданное текущим днем месяца, к 1-му дню нового месяца, указанного в качестве параметра, чтобы вернуть новую дату. Например, если текущее значение — 31 января 2016 года, вызов setMonth со значением 1 вернет 2 марта 2016 года. Это связано с тем, что в 2016 году в феврале было 29 дней.

Поскольку setMonth() работает с местным временем, пересечение границы перехода на летнее время (DST) может привести к иному прошедшему времени, чем ожидалось. Например, если установка месяца пересекает переход «весна-вперед» (потеря часа), разница во временных отметках между новой и старой датой будет на один час меньше, чем номинальная разница в днях, умноженная на 24 часа. И наоборот, пересечение перехода «осень-назад» (получение часа) приводит к дополнительному часу. Если вам нужно скорректировать дату на фиксированное количество времени, рассмотрите возможность использования setUTCMonth() или setTime().

Если новое местное время попадает в диапазон перехода смещения, точное время определяется с использованием того же поведения, что и опция disambiguation: "compatible" в Temporal. То есть, если местное время соответствует двум моментам, выбирается более ранний; если местного времени не существует (есть пробел), мы продвигаемся вперед на продолжительность этого пробела.

Примеры

Использование setMonth()

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

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

Совместимость с браузерами

Смотрите также

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