Esta página foi traduzida do inglês pela comunidade. Saiba mais e junte-se à comunidade MDN Web Docs.

View in English Always switch to English

Date.prototype.setTime()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julho de 2015⁩.

O método setTime() atribui ao objecto Date a hora representada pelo número de milisegundos desde 1 de janeiro de 1970 as 00:00:00 UTC.

Experimente

const launchDate = new Date("July 1, 1999, 12:00:00");
const futureDate = new Date();
futureDate.setTime(launchDate.getTime());

console.log(futureDate);
// Expected output: "Thu Jul 01 1999 12:00:00 GMT+0200 (CEST)"

const fiveMinutesInMillis = 5 * 60 * 1000;
futureDate.setTime(futureDate.getTime() + fiveMinutesInMillis);

console.log(futureDate);
// Expected output: "Thu Jul 01 1999 12:05:00 GMT+0200 (CEST)"
// Note: your timezone may vary

Sintáxe

dateObj.setTime(timeValue)

Parâmetros

timeValue

Um inteiro representando o número de milisegundos desde 1 de janeiro 1970, 00:00:00 UTC.

Valor retornado

O número de milisegundos entre 1 de janeiro de 1970 00:00:00 UTC e a data atualizada (efetivamente, o valor do argumento).

Descrição

Use o método setTime() para ajudar a atribuir data e hora para outro objeto Date.

Exemplos

Usando setTime()

js
var theBigDay = new Date("July 1, 1999");
var sameAsBigDay = new Date();
sameAsBigDay.setTime(theBigDay.getTime());

Especificações

Specification
ECMAScript® 2026 Language Specification
# sec-date.prototype.settime

Compatibilidade com navegadores

Veja também