Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Date.prototype.setTime: reemplazar el valor temporal

setTime reemplaza el valor de un objeto Date por milisegundos desde la época, aplica TimeClip y devuelve el nuevo valor.

Versión: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxis

date.setTime(timeValue)

date.setTime(timeValue) convierte el argumento con ToNumber, trunca una fracción hacia cero y guarda milisegundos desde 1970-01-01T00:00:00Z. La operación no depende de la zona local ni de los campos anteriores. Devuelve el valor guardado, que después coincide con getTime().

Un valor no finito, NaN, argumento omitido o valor absoluto mayor que 8.64e15 invalida la fecha y devuelve NaN. Una llamada posterior válida puede restaurar un Date inválido. BigInt y Symbol lanzan TypeError durante ToNumber; la coerción de objetos también puede lanzar.

Un receptor sin estado interno Date lanza TypeError y los argumentos adicionales se ignoran. Usa setTime para restaurar una marca temporal o desplazar un instante en milisegundos. El método existe desde ECMAScript 1.

Ejemplos

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

Fuentes