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

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 setUTCDate() atribui o dia do mês para uma data especifica de acordo com o horário universal.

Experimente

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

console.log(event.getUTCDate());
// Expected output: 20

event.setUTCDate(19);

console.log(event.getUTCDate());
// Expected output: 19

Sintaxe

dateObj.setUTCDate(dayValue)

Parâmetros

dayValue

Um inteiro entre 1 e 31, representando o dia do mês.

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 um parâmetro que você especificou está fora do alcance esperado, setUTCDate() tentará atualizar a informação da data no objeto Date. Por exemplo, se você usar 40 para dayValue, e o mês guardado no objeto Date é Junho, o dia será trocado para 10 e o mês será incrementado para Julho.

Exemplos

Usando setUTCDate()

js
var theBigDay = new Date();
theBigDay.setUTCDate(20);

Especificações

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

Compatibilidade com navegadores

Veja também