Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje