JavaScript метод Date.setDate()

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

JavaScript метод setDate() объекта Date устанавливает день месяца для указанной даты по местному времени.

В качестве возвращаемого значения метода setDate() вы получаете количество миллисекунд между 1 января 1970 00:00:00 UTC и заданной датой.

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

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

JavaScript синтаксис:

dateObj.setDate(dayValue);

dayValue - Integer

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

ECMAScript 1st Edition (ECMA-262). Реализовано в JavaScript 1.0.

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

Параметр	Описание
dayValue	Целое число, представляющее день месяца. Обязательный параметр. Ожидаемые значения лежат в диапазоне от 1 до 31, но другие значения возможны, например: значение 0 приведет к последнему дню предыдущего месяца значение -1 приведет ко дню, предшествующему последнему дню предыдущего месяца, значение -10 соответственно приведет к сдвигу назад от последнего дня предыдущего месяца. Если месяц имеет 30 дней, то значение 31 будет соответствовать первому дню следующего месяца, а значение 35 пятому дню следующего месяца и так далее.

Параметр

Описание

dayValue

Целое число, представляющее день месяца. Обязательный параметр.
Ожидаемые значения лежат в диапазоне от 1 до 31, но другие значения возможны, например:

значение 0 приведет к последнему дню предыдущего месяца
значение -1 приведет ко дню, предшествующему последнему дню предыдущего месяца, значение -10 соответственно приведет к сдвигу назад от последнего дня предыдущего месяца.

Если месяц имеет 30 дней, то значение 31 будет соответствовать первому дню следующего месяца, а значение 35 пятому дню следующего месяца и так далее.

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

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

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

someDay.setDate(0); // устанавливает день месяца для указанной даты по местному времени
console.log(someDay); // Thu Jan 31 2019 12:00:00 GMT+0300 (Москва, стандартное время)

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

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

someDay.setDate(31); // устанавливает день месяца для указанной даты по местному времени
console.log(someDay); // Sun Mar 03 2019 12:00:00 GMT+0300 (Москва, стандартное время)

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

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

someDay.setDate(-40); // устанавливает день месяца для указанной даты по местному времени
console.log(someDay); // Sat Dec 22 2018 12:00:00 GMT+0300 (Москва, стандартное время)

JavaScript Date