База знанияИзпитен център
BGБългарски
Избери език13

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

Източници