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