Date.prototype.setSeconds()

Baseline Widely available

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

O método setSeconds() atribui os segundos na data especificada de acordo com o tempo local.

Experimente

Sintaxe

dateObj.setSeconds(secondsValue[, msValue])

Versões anteriores ao JavaScript 1.3

dateObj.setSeconds(secondsValue)

Parâmetros

secondsValue

Um inteiro entre 0 e 59, representando os segundos.

msValue

Opcional. Um número entre 0 e 999, representando os milissegundos.

Valor de retorno

O número de milissegundos entre 1 de Janeiro de 1970 00:00:00 UTC e a data atualizada.

Descrição

Se você não especifica o parâmetro msValue, o valor retornado do método getMilliseconds() é utilizado.

Se um parâmetro que você especificou está fora do alcance esperado, setSeconds() tentará atualizar a informação da data no objeto Date. Por exemplo, se você usar 100 para secondsValue, os minutos guardados no objeto Date serão incrementados em 1, e 40 serão usados para os segundos.

Exemplos

Usando setSeconds()

js
var theBigDay = new Date();
theBigDay.setSeconds(30);

Especificações

Specification
ECMAScript® 2025 Language Specification
# sec-date.prototype.setseconds

Compatibilidade com navegadores

BCD tables only load in the browser

Veja também