É meio confuso, mas segundo a documentação de Date
, o valor numérico do mês é indexado em zero. Ou seja, janeiro é zero, fevereiro é 1, etc.
Portanto, new Date(1997, 1, 22)
cria uma data referente a 22 de fevereiro de 1997. O método getMonth()
também usa esta mesma regra, portanto nesse caso ele retornará 1
(que corresponde a fevereiro).
Mas quando a data é impressa via console.log
, ela é convertida para algum formato (no caso, o formato foi "1997-02-22T03:00:00.000Z"), e aí o mês assume o valor correto (janeiro é 1, fevereiro é 2, etc).
let d = new Date(1997, 1, 22);
console.log(d); // 1997-02-22T03:00:00.000Z
console.log(d.getMonth()); // 1
Ou seja, dependendo da situação, você tem que se atentar para usar os valores indexados em zero ou em 1.
No construtor de Date
(quando este recebe valores numéricos) e no retorno de getMonth()
(e também no valor passado para o método setMonth
), os valores são indexados em zero.
Já os métodos que formatam a data usam o valor correto (indexado em 1):
let d = new Date(1997, 1, 22);
console.log(d.getMonth()); // 1
console.log(d.toISOString()); // 1997-02-22T03:00:00.000Z
console.log(d.toLocaleDateString('pt-BR')); // 22/02/1997
// mudando o mês para dezembro
d.setMonth(11);
console.log(d.toISOString()); // 1997-12-22T02:00:00.000Z
console.log(d.toLocaleDateString('pt-BR')); // 22/12/1997
Outro ponto que pode confundir mais um pouco é que, quando você passa uma string no formato ISO 8601 para o construtor, aí os meses devem ter os valores corretos:
// passando uma string no formato ISO 8601, fevereiro deve ser mês 2
let d = new Date('1997-02-22');
console.log(d.getMonth()); // 1
console.log(d.toISOString()); // 1997-02-22T00:00:00.000Z
console.log(d.toLocaleDateString('pt-BR')); // 21/02/1997
Mas repare que nesse caso houve uma diferença: o horário é meia-noite em UTC (o "Z" no final indica que está em UTC), e toLocaleDateString
retornou dia 21, pois este método usa o timezone do browser (que no meu caso está no Horário de Brasília), e como dia 22 à meia-noite em UTC é igual a dia 21 às 21h do Horário de Brasília, ocorre esta discrepância.
Já quando você usa os valores numéricos (new Date(1997, 1, 22)
), o Date
criado corresponde à meia-noite no timezone do browser (no caso, meia-noite no horário de Brasília, que equivale às 3 da manhã em UTC - por isso no primeiro caso o horário é impresso como "03:00:00.000Z"). Esse comportamento é explicado em mais detalhes aqui.
Só para deixar "mais legal" ainda, o construtor de Date
não reclama se você passar um mês maior que 11:
let d = new Date(1997, 12, 22);
console.log(d); // 1998-01-22T02:00:00.000Z
console.log(d.getMonth()); // 0
Pois é, se passar o mês 12, ele cria uma data referente à janeiro do ano seguinte.