JavaScript метод Date.setMinutes()

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

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

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

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

JavaScript синтаксис:

dateObj.setMinutes( minutesValue );
dateObj.setMinutes( minutesValue, secondsValue);
dateObj.setMinutes( minutesValue, secondsValue, msValue );

minutesValue - Integer
secondsValue - Integer
msValue - Integer

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

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

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

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

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

Если указанный параметр находится за пределами ожидаемого диапазона, то метод setMinutes() пытается соответствующим образом обновить другие параметры и информацию о дате в объекте 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.setMinutes(23); // устанавливаем минуты для указанной даты по местному времени
console.log(someDay); // Thu Feb 14 2019 12:23:00 GMT+0300 (Москва, стандартное время)

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

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

someDay.setMinutes(1000); // устанавливаем минуты для указанной даты по местному времени
console.log(someDay); // Fri Feb 15 2019 04:40:00 GMT+0300 (Москва, стандартное время)

JavaScript Date