O que é e como funciona
A pergunta "quanto tempo tem" refere-se ao cálculo de duração entre duas datas. É um problema simples na teoria, mas na prática envolve fuso horário, anos bissextos e formatos de data inconsistentes. Vou explicar como resolver isso.
Como calcular quanto ano tem
O método básico é subtrair a data inicial da data final. Mas aí mora o problema. Anos bissextos, meses com 28, 30 ou 31 dias, e datas em formatos diferentes estragam tudo se você não tomar cuidado. No Python, a abordagem correta usa o módulo datetime. Você cria dois objetos de data e subtrai um do outro, resultando em um objeto timedelta, que entrega dias, segundos e microssegundos. A partir dos dias, você converte para anos dividindo por 365.25.
Exemplo rápido: import datetime
data_inicial = datetime.date(1995, 7, 15)
data_final = datetime.date(2024, 3, 10)
diferenca = data_final - data_inicial
anos = diferenca.days / 365.25
print(f"Quantos anos tem: {anos:.2f}")
Isso resulta em aproximadamente 28.67 anos. Simples.
O problema que ninguém conta
O cálculo por 365.25 funciona bem na maioria dos casos, mas tem uma falha séria: se as datas estiverem muito próximas a um ano bissexto, o erro pode ficar em torno de 0.25 anos. Já vi gente usar essa fórmula em sistemas de aposentadoria e obter resultado errado por dois anos inteiros. A alternativa mais precisa é usar o módulo dateutil.relativedelta, que calcula a diferença exata considerando anos, meses e dias separadamente. Ele lida com anos bissextos, variação de dias por mês e tudo mais automaticamente.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Segue a versão corrigida: from dateutil.relativedelta import relativedelta
ano_exato = relativedelta(data_final, data_inicial).years
mes_exato = relativedelta(data_final, data_inicial).months
dia_exato = relativedelta(data_final, data_inicial).days
print(f"{ano_exato} anos, {mes_exato} meses e {dia_exato} dias")
Isso retorna 28 anos, 7 meses e 24 dias — bem mais útil do que um decimal solto.
Armazenamento e formatação
Se você está construindo algo que calcula quanto tempo tem entre datas repetidamente, armazene as datas sempre no padrão ISO 8601 (YYYY-MM-DD). Evite formatos como DD/MM/YYYY, porque o SQL e muitas bibliotecas interpretam errado. Já perdi noites de sono tentando debugar query que via 01/03/2024 como março em vez de janeiro. Se o problema for com usuários inserindo data manualmente, use um campo de entrada com type="date" no HTML. O navegador cuida da formatação e valida automaticamente datas impossíveis como 30/02/2023.
Quando isso não funciona
O cálculo de diferença entre datas não leva em conta fusos horários por padrão. Se seu sistema envolve datas de diferentes regiões, use datetime.timezone para padronizar tudo em UTC antes de calcular. Senão, dois horários iguais em fusos diferentes vão gerar diferença zero ou diferença errada dependendo de como a conversão é feita. Outro cenário problemático: datas históricas antes de 1970 em sistemas Windows. A biblioteca padrão do Python não suporta datas negativas (antes de 1970) em algumas plataformas. Nesses casos, use a biblioteca pendulum, que resolve isso sem dor de cabeça.
Resumo prático: use relativedelta para precisão, ISO 8601 para armazenamento, UTC para fusos. O resto é configuração de infraestrutura.
