Date.prototype.setMinutes()

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

Попробовать

const event = new Date("August 19, 1975 23:15:30");

event.setMinutes(45);

console.log(event.getMinutes());
// Expected output: 45

console.log(event);
// Expected output: "Tue Aug 19 1975 23:45:30 GMT+0200 (CEST)"
// Note: your timezone may vary

Синтаксис

setMinutes(minutesValue)
setMinutes(minutesValue, secondsValue)
setMinutes(minutesValue, secondsValue, msValue)

Параметры

minutesValue

Целое число от 0 до 59, представляющее минуты.

secondsValue Необязательный

Целое число от 0 до 59, представляющее секунды. Если вы указываете secondsValue, вы также должны указать minutesValue.

msValue Необязательный

Целое число от 0 до 999, представляющее миллисекунды. Если вы указываете msValue, вы также должны указать minutesValue и secondsValue.

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

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

Описание

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

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

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

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

Примеры

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

const theBigDay = new Date();
theBigDay.setMinutes(45);

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

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

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

• Date.prototype.getMinutes()
• Date.prototype.setUTCMinutes()