CKTIS / JavaScript
Date.prototype.setTime: substituir o valor temporal
setTime substitui o valor de um objeto Date por milissegundos desde a época, aplica TimeClip e devolve o novo valor.
Versão: ECMAScript 1 onward; example target: Node.js 24.22.2
Sintaxe
date.setTime(timeValue)date.setTime(timeValue) converte o argumento com ToNumber, trunca uma fração para zero e guarda milissegundos desde 1970-01-01T00:00:00Z. A operação não depende do fuso local nem dos campos anteriores. Devolve o valor guardado, que depois coincide com getTime().
Valor não finito, NaN, argumento omitido ou valor absoluto acima de 8.64e15 invalida a data e devolve NaN. Uma chamada válida posterior pode restaurar um Date inválido. BigInt e Symbol lançam TypeError durante ToNumber; a coerção de objetos também pode lançar.
Um receiver sem estado interno Date lança TypeError e argumentos adicionais são ignorados. Usa setTime para restaurar uma marca temporal ou deslocar um instante em milissegundos. O método existe desde ECMAScript 1.
Exemplos
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());Resultado
1704067200123 2024-01-01T00:00:00.123Z NaN true 0 1970-01-01T00:00:00.000Z