Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Date.prototype.setTime: ustaw wartość czasu

setTime zastępuje wartość czasu obiektu Date liczbą milisekund od epoki, stosuje TimeClip i zwraca nową wartość.

Wersja: ECMAScript 1 onward; example target: Node.js 24.22.2

Składnia

date.setTime(timeValue)

date.setTime(timeValue) konwertuje argument przez ToNumber, obcina ułamek w stronę zera i ustawia wynik jako milisekundy od 1970-01-01T00:00:00Z. Operacja nie zależy od lokalnej strefy ani poprzednich pól daty. Zwraca ustawioną liczbę milisekund, więc wynik jest taki sam jak późniejsze getTime().

Wartość niekończona, NaN, brak argumentu lub moduł większy niż 8.64e15 unieważnia datę i zwraca NaN. Późniejsze wywołanie z poprawną wartością może przywrócić niepoprawny Date. BigInt i Symbol powodują TypeError podczas ToNumber; konwersja obiektu także może rzucić.

Receiver bez wewnętrznego stanu Date powoduje TypeError, a dodatkowe argumenty są ignorowane. Używaj setTime do odtworzenia znacznika czasu lub przesunięcia chwili o liczbę milisekund. Metoda istnieje od ECMAScript 1.

Przykłady

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());

Wynik

1704067200123
2024-01-01T00:00:00.123Z
NaN true
0 1970-01-01T00:00:00.000Z

Źródła