Somar meses e calcular idade sem erro: o problema do dia 31

// Soma meses a uma data AAAA-MM-DD. Se o dia não existe no mês final, usa o último dia dele:
// 31/01 + 1 mês = 28/02 (ou 29/02 em ano bissexto). É a regra do Excel (DATAM) e do relativedelta.
function somarMeses(data, meses) {
  const [a, m, d] = data.split('-').map(Number);
  const total = a * 12 + (m - 1) + meses;
  const ano = Math.floor(total / 12);
  const mes = (total % 12) + 1;
  const ultimoDia = new Date(Date.UTC(ano, mes, 0)).getUTCDate(); // dia 0 do mês seguinte
  const dia = Math.min(d, ultimoDia);
  return `${String(ano).padStart(4, '0')}-${String(mes).padStart(2, '0')}-${String(dia).padStart(2, '0')}`;
}

console.log(somarMeses('2026-01-31', 1)); // 2026-02-28
console.log(somarMeses('2024-01-31', 1)); // 2024-02-29
console.log(somarMeses('2026-03-31', -1)); // 2026-02-28

Sem setMonth, que transborda o dia.

import calendar
from datetime import date


def somar_meses(d: date, meses: int) -> date:
    """Soma meses mantendo o dia; se ele não existe no mês final, usa o último dia do mês."""
    total = d.year * 12 + (d.month - 1) + meses
    ano, mes = divmod(total, 12)
    mes += 1
    ultimo = calendar.monthrange(ano, mes)[1]
    return date(ano, mes, min(d.day, ultimo))


print(somar_meses(date(2026, 1, 31), 1))  # 2026-02-28
print(somar_meses(date(2024, 1, 31), 1))  # 2024-02-29
# Com a biblioteca dateutil, o mesmo resultado: date(2026, 1, 31) + relativedelta(months=1)

<?php
// Soma meses mantendo o dia; se ele não existe no mês final, usa o último dia do mês.
// Cuidado: (new DateTime('2026-01-31'))->modify('+1 month') dá 2026-03-03, porque o PHP "transborda" o dia.
function somarMeses(string $data, int $meses): string
{
    [$a, $m, $d] = array_map('intval', explode('-', $data));
    $total = $a * 12 + ($m - 1) + $meses;
    $ano = intdiv($total, 12);
    $mes = $total % 12 + 1;
    $ultimo = (int) date('t', mktime(0, 0, 0, $mes, 1, $ano)); // dias do mês
    return sprintf('%04d-%02d-%02d', $ano, $mes, min($d, $ultimo));
}

echo somarMeses('2026-01-31', 1), PHP_EOL; // 2026-02-28
echo (new DateTime('2026-01-31'))->modify('+1 month')->format('Y-m-d'), PHP_EOL; // 2026-03-03

A segunda linha mostra o transbordo do modify do PHP.

// Idade em anos completos na data de referência (padrão: hoje), com datas no formato AAAA-MM-DD.
function calcularIdade(nascimento, referencia = new Date().toISOString().slice(0, 10)) {
  const [an, mn, dn] = nascimento.split('-').map(Number);
  const [ar, mr, dr] = referencia.split('-').map(Number);
  let idade = ar - an;
  // Ainda não fez aniversário neste ano? Tira 1.
  // Nesta conta, quem nasceu em 29/02 faz aniversário em 1º/03 nos anos não bissextos.
  if (mr < mn || (mr === mn && dr < dn)) idade--;
  return idade;
}

console.log(calcularIdade('1990-10-02', '2026-10-01')); // 35
console.log(calcularIdade('1990-10-02', '2026-10-02')); // 36

from datetime import date


def calcular_idade(nascimento: date, referencia: date | None = None) -> int:
    """Idade em anos completos na data de referência (padrão: hoje)."""
    referencia = referencia or date.today()
    # Ainda não fez aniversário neste ano? A comparação de tuplas resolve: (mês, dia).
    # Nesta conta, quem nasceu em 29/02 faz aniversário em 1º/03 nos anos não bissextos.
    ainda_nao = (referencia.month, referencia.day) < (nascimento.month, nascimento.day)
    return referencia.year - nascimento.year - ainda_nao


print(calcular_idade(date(1990, 10, 2), date(2026, 10, 1)))  # 35
print(calcular_idade(date(1990, 10, 2), date(2026, 10, 2)))  # 36