JavaScript метод Date.setSeconds()

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

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

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

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

JavaScript синтаксис:

dateObj.setSeconds( secondsValue );
dateObj.setSeconds( secondsValue, msValue );

secondsValue - Integer
msValue - Integer

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

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

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

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

Параметр

Описание

secondsValue

Целое число от 0 до 59, представляющее секунды. Если значение больше 59, то значение времени будет увеличиваться на дополнительные секунды. Обязательный параметр.

msValue

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

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

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

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

JavaScript Date