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.

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® 2025 Language Specification # sec-date.prototype.setdate

Compatibilidade com navegadores

BCD tables only load in the browser