Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Date.prototype.setTime: sostituire il valore temporale

setTime sostituisce il valore di un oggetto Date con millisecondi dall’epoca, applica TimeClip e restituisce il nuovo valore.

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

Sintassi

date.setTime(timeValue)

date.setTime(timeValue) converte l’argomento con ToNumber, tronca una frazione verso zero e memorizza millisecondi da 1970-01-01T00:00:00Z. L’operazione non dipende dal fuso locale né dai campi precedenti. Restituisce il valore memorizzato, che poi coincide con getTime().

Un valore non finito, NaN, argomento omesso o valore assoluto oltre 8.64e15 invalida la data e restituisce NaN. Una chiamata valida successiva può ripristinare un Date non valido. BigInt e Symbol generano TypeError durante ToNumber; anche la coercizione di oggetti può generare.

Un receiver senza stato interno Date genera TypeError e gli argomenti aggiuntivi sono ignorati. Usa setTime per ripristinare un timestamp o spostare un istante di millisecondi. Il metodo esiste da ECMAScript 1.

Esempi

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

Risultato

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

Fonti