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 July 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()
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 |