Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes