CKTIS / JavaScript
Date.prototype.setTime: замяна на времевата стойност
setTime заменя времевата стойност на обект Date с милисекунди от епохата, прилага TimeClip и връща новата стойност.
Версия: ECMAScript 1 onward; example target: Node.js 24.22.2
Синтаксис
date.setTime(timeValue)date.setTime(timeValue) преобразува аргумента с ToNumber, отрязва дробта към нула и съхранява милисекунди от 1970-01-01T00:00:00Z. Операцията не зависи от местната зона или предишните полета. Връща съхранената стойност, която после съвпада с getTime().
Безкрайна стойност, NaN, липсващ аргумент или абсолютна стойност над 8.64e15 прави датата невалидна и връща NaN. По-късно валидно извикване може да възстанови невалиден Date. BigInt и Symbol хвърлят TypeError при ToNumber; преобразуването на обект също може да хвърли.
Receiver без вътрешно състояние Date хвърля TypeError; допълнителните аргументи се игнорират. Използвайте setTime за възстановяване на печат или преместване с милисекунди. Методът съществува от ECMAScript 1.
Примери
const date = new Date(0);
console.log(date.setTime(1704067200123.9));
console.log(date.toISOString());
console.log(date.setTime(8.64e15 + 1), Number.isNaN(date.getTime()));
console.log(date.setTime(0), date.toISOString());Резултат
1704067200123 2024-01-01T00:00:00.123Z NaN true 0 1970-01-01T00:00:00.000Z