Date.prototype.setMilliseconds()

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

Попробуйте

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

console.log(event.getMilliseconds());
// Expected output: 0

event.setMilliseconds(456);

console.log(event.getMilliseconds());
// Expected output: 456

Синтаксис

setMilliseconds(millisecondsValue)

Параметры

millisecondsValue

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

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

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

Описание

Если вы укажете число вне ожидаемого диапазона, информация о дате в объекте Date будет соответственно обновлена. Например, если вы укажете 1005, количество секунд увеличится на 1, а 5 будет использовано для миллисекунд.

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

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

Примеры

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

const theBigDay = new Date();
theBigDay.setMilliseconds(100);

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

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

См. также

• Date.prototype.getMilliseconds()
• Date.prototype.setUTCMilliseconds()