JavaScript метод Date.setHours()

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

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

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

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

JavaScript синтаксис:

dateObj.setHours(hoursValue);
dateObj.setHours(hoursValue, minutesValue );
dateObj.setHours(hoursValue, minutesValue, secondsValue);
dateObj.setHours(hoursValue, minutesValue, secondsValue, msValue );

hoursValue - Integer
minutesValue - Integer
secondsValue - Integer
msValue - Integer

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

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

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

Параметр	Описание
hoursValue	Целое число от 0 до 23, представляющее час. Если значение больше 23, то значение времени будет увеличиваться на дополнительные часы. Обязательный параметр.
minutesValue	Целое число от 0 до 59, представляющее минуты. Если значение больше 59, то значение времени будет увеличиваться на дополнительные минуты. Необязательный параметр.
secondsValue	Целое число от 0 до 59, представляющее секунды. Если значение больше 59, то значение времени будет увеличиваться на дополнительные секунды. Если вы указываете значение этого параметра, то необходимо также указать значение для минут. Необязательный параметр.
msValue	Целое число от 0 до 999, представляющее миллисекунды. Если значение больше 999, то значение времени будет увеличиваться на дополнительные миллисекунды. Если вы указываете значение этого параметра, то необходимо также указать значение для минут и секунд. Необязательный параметр.

Если параметры minutesValue, secondsValue и msValue не указаны, то используются значения, возвращаемые методами getMinutes(), getSeconds() и getMilliseconds().

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

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

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

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

someDay.setHours(23); // устанавливаем часы для указанной даты по местному времени
console.log(someDay); // Thu Feb 14 2019 23:00:00 GMT+0300 (Москва, стандартное время)

someDay.setHours(10, 30); // устанавливаем часы для указанной даты по местному времени
console.log(someDay); // Thu Feb 14 2019 10:30:00 GMT+0300 (Москва, стандартное время)

someDay.setHours(15, 27, 59, 999); // устанавливаем часы для указанной даты по местному времени
console.log(someDay); // Thu Feb 14 2019 15:27:59 GMT+0300 (Москва, стандартное время)

someDay.setHours(48); // устанавливаем часы для указанной даты по местному времени
console.log(someDay); // Sat Feb 16 2019 00:00:00 GMT+0300 (Москва, стандартное время)

JavaScript Date