Date.prototype.setSeconds()

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

Попробуйте

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

event.setSeconds(42);

console.log(event.getSeconds());
// Expected output: 42

console.log(event);
// Expected output: "Sat Apr 19 1975 23:15:42 GMT+0100 (CET)"
// Note: your timezone may vary

Синтаксис

setSeconds(secondsValue)
setSeconds(secondsValue, msValue)

Параметры

secondsValue

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

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

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

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

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

Описание

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

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

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

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

Примеры

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

const theBigDay = new Date();
theBigDay.setSeconds(30);

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

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

См. также

• Date.prototype.getSeconds()
• Date.prototype.setUTCSeconds()