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.setDate()

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 setDate() configura o dia do objeto Date relativamente ao início do mês configurado previamente.

Experimente

const event = new Date("August 19, 1975 23:15:30");

event.setDate(24);

console.log(event.getDate());
// Expected output: 24

event.setDate(32);
// Only 31 days in August!

console.log(event.getDate());
// Expected output: 1

Sintaxe

dateObj.setDate(dayValue)

Parâmetros

dayValue

Um número inteiro que representa o dia do mês.

Valor de retorno

O número de milisegundos entre 1o de janeiro de 1970 00:00:00 UTC e a data indicada (o objeto Date é mudado no lugar).

Descrição

Se o dayValue estiver fora da extensão de valores de data para o mês, setDate() vai atualizar o objeto Date consequentemente.

Por exemplo, se 0 for fornecido para dayValue, a data será configurada para o último dia do mês anterior.

Se um número negativo for fornecido para dayValue, a data será configurada contando-se regressivamente desde o último dia do mês anterior. -1 resultará na data sendo configurada para um dia antes do último dia o mês anterior.

Exemplos

Usando setDate()

js
var theBigDay = new Date(1962, 6, 7); // 1962-07-07 (7th of July 1962)
theBigDay.setDate(24); // 1962-07-24 (24th of July 1962)
theBigDay.setDate(32); // 1962-08-01 (1st of August 1962)
theBigDay.setDate(22); // 1962-08-22 (22th of August 1962)
theBigDay.setDate(0); // 1962-07-31 (31th of July 1962)
theBigDay.setDate(98); // 1962-10-06 (6th of October 1962)
theBigDay.setDate(-50); // 1962-08-11 (11th of August 1962)

Especificações

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

Compatibilidade com navegadores

Veja também