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