Calculadora de Soma/Subtração de Datas

Uma calculadora de soma ou subtração de datas encontra uma data-alvo movendo uma data inicial para frente ou para trás por dias, semanas, meses ou anos. Ela ajuda em renovações, retornos, prazos contratuais, garantias, lembretes e planejamento de projetos sem contar tudo manualmente no calendário. A parte mais delicada não é somar dias, mas lidar com os limites reais do calendário: meses têm tamanhos diferentes, anos bissextos alteram fevereiro e uma data como 31 de janeiro nem sempre existe no mês seguinte. A ferramenta fornece um resultado prático para planejamento rápido. Ela conta tempo de calendário, não dias úteis, feriados, regras regionais ou prazos legais específicos.

A aritmética de datas nesta ferramenta é construída sobre o calendário gregoriano proléptico conforme implementado pelo objeto Date do ECMAScript. Os meses em JavaScript são indexados a partir de zero (janeiro é 0, dezembro é 11), o que é a maior fonte de erros de deslocamento em código de datas. Adicionar dias é simples: new Date(d.getTime() + n * 86_400_000). Adicionar meses é mais difícil porque os meses têm 28, 29, 30 ou 31 dias: o padrão date.setMonth(date.getMonth() + n) transborda quando o mês resultante é mais curto que o dia de origem, então 31 de janeiro + 1 mês produz 3 de março em vez de 28 de fevereiro (o motor carrega os 3 dias extras para março). Esta ferramenta detecta o transbordo comparando date.getMonth() após setMonth e limita o dia ao último dia do mês de destino quando necessário, seguindo o comportamento de moment.js, date-fns e Plain Date.add() do Temporal. Os anos bissextos seguem a regra gregoriana padrão: um ano é bissexto se divisível por 4, exceto os séculos, que devem ser divisíveis por 400. Então 1900 e 2100 são anos comuns, enquanto 2000 foi bissexto e 2024 também. Isso é relevante sempre que um cálculo atravessa 29 de fevereiro: 29 de janeiro + 1 mês + 1 mês em 2023 dá 29 de março, mas em 2024 o transbordo atinge 29 de fevereiro (uma data válida) e depois 29 de março, sem necessidade de limitação. O corte de 1582 para a transição juliana-gregoriana é ignorado aqui porque o calendário gregoriano proléptico estende as regras indefinidamente para o passado; datas anteriores a 15 de outubro de 1582 são tecnicamente anacrônicas, mas ainda calculam corretamente para fins modernos. O tratamento de fuso horário é uma dimensão separada: o Date armazena um instante UTC internamente e aplica o fuso horário IANA do sistema (ex.: America/New_York, Asia/Shanghai) apenas ao chamar .getDate(), .getMonth() ou .toLocaleString(). Seguem-se dois problemas: (1) uma data construída a partir de uma string ISO sem sufixo Z ("2026-06-10") é interpretada como meia-noite UTC, mas "2026-06-10T00:00:00" sem o Z é interpretada como meia-noite horário local, e a mesma date.getDate() pode retornar 9 ou 10 dependendo do offset do usuário; (2) as transições de horário de verão na primavera (pulam 02:00-03:00) e no outono (repetem 01:00-02:00) tornam alguma aritmética ambígua, então uma adição de "+24 horas" pode cair em um relógio de parede que está 23 ou 25 horas adiante. Para aritmética de dias úteis, dias da semana ou com feriados, o resultado do calendário deve ser pós-processado contra uma lista de feriados específica da região (ex.: através do pacote npm date-holidays ou um calendário personalizado) em vez de depender do transbordo simples.

• Os meses do JS Date são indexados a partir de zero: Janeiro = 0, Dezembro = 11; o erro de deslocamento é o mais comum.
• Transbordo de setMonth: 31 de jan + 1 mês dá 3 de mar, não 28 de fev; a ferramenta limita ao fim do mês comparando getMonth() após setMonth.
• Ano bissexto: divisível por 4, exceto anos de século que devem ser divisíveis por 400 (então 1900 não, 2000 sim, 2024 sim).
• ISO 8601 sem Z ("2026-06-10T00:00:00") interpreta como horário local; com Z é UTC — getDate() pode retornar dias diferentes.
• Transições de horário de verão criam dias de 23 e 25 horas; a adição de +24 nem sempre equivale a +1 dia de calendário.
• Cálculo em nível de dias é exato via getTime() + n * 86_400_000; unidades maiores cascateiam por setMonth/setFullYear com limitação.
• Aritmética de dias úteis e com feriados deve ser adicionada por cima via tabela de calendário específica da região — não está no motor.