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

CKTIS / JavaScript

Date.prototype.getMonth: índice do mês local

getMonth devolve o mês local como índice de 0 para janeiro até 11 para dezembro.

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

Sintaxe

date.getMonth()

date.getMonth() devolve o índice do mês local como Number: 0 é janeiro e 11 dezembro. A numeração desde zero causa erros frequentes; para mostrar usa nomes ou Intl.DateTimeFormat, não o valor bruto. getUTCMonth() fornece o campo UTC.

O método não recebe argumentos, não altera a data e ignora argumentos adicionais. Devolve NaN para um Date inválido. Um receiver sem estado interno Date, como Date.prototype.getMonth.call({}), lança TypeError.

O fuso pode mudar o mês de instantes perto do limite. O índice coincide com o argumento mês dos construtores Date e de setMonth, que normaliza valores fora de 0–11. O método existe desde ECMAScript 1.

Exemplos

const monthNames = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
const date = new Date(2024, 10, 5, 12);
console.log(date.getMonth(), monthNames[date.getMonth()]);

date.setMonth(date.getMonth() + 2);
console.log(date.getFullYear(), date.getMonth(), monthNames[date.getMonth()]);
console.log(Number.isNaN(new Date(NaN).getMonth()));

Resultado

10 Nov
2025 0 Jan
true

Fontes