Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

Date.prototype.getDate: dia local do mês

getDate devolve o dia do mês entre 1 e 31, calculado no fuso horário local do ambiente.

Versão: ECMAScript 1 onward; example target: Node.js 24.22.2

Sintaxe

date.getDate()

date.getDate() devolve como Number o dia local do mês entre 1 e 31. Não é o dia da semana; esse vem de getDay(). O resultado depende do fuso local do ambiente, portanto a mesma marca temporal pode ter outra data ao mover o programa. Para UTC usa getUTCDate().

O método não recebe argumentos nem altera a data; argumentos adicionais são ignorados. Para um Date inválido cujo valor temporal é NaN, devolve NaN. Um receiver sem estado interno Date, como Date.prototype.getDate.call({}), lança TypeError.

Serve para mostrar um dia de calendário local ou como entrada de setDate, que normaliza valores fora do intervalo através de meses adjacentes. O método existe desde ECMAScript 1.

Exemplos

const date = new Date(2024, 1, 29, 12);
console.log(date.getDate());

date.setDate(date.getDate() + 1);
console.log(date.getDate(), date.getMonth());
console.log(Number.isNaN(new Date(NaN).getDate()));

Resultado

29
1 2
true

Fontes