CKTIS / JavaScript
Date.prototype.setTime: nahradit časovou hodnotu
setTime nahradí časovou hodnotu objektu Date milisekundami od epochy, použije TimeClip a vrátí novou hodnotu.
Verze: ECMAScript 1 onward; example target: Node.js 24.22.2
Syntaxe
date.setTime(timeValue)date.setTime(timeValue) převede argument pomocí ToNumber, ořízne zlomek k nule a uloží milisekundy od 1970-01-01T00:00:00Z. Operace nezávisí na místním pásmu ani předchozích polích. Vrací uloženou hodnotu, která pak odpovídá getTime().
Nekonečná hodnota, NaN, chybějící argument nebo absolutní hodnota nad 8.64e15 datum zneplatní a vrátí NaN. Pozdější platné volání může neplatný Date obnovit. BigInt a Symbol při ToNumber vyvolají TypeError; převod objektu může také vyhodit.
Receiver bez interního stavu Date vyvolá TypeError; další argumenty se ignorují. Použijte setTime k obnovení značky nebo posunu okamžiku o milisekundy. Metoda existuje od ECMAScript 1.
Příklady
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());Výsledek
1704067200123 2024-01-01T00:00:00.123Z NaN true 0 1970-01-01T00:00:00.000Z