Cálculos com datas

Duração é um tipo à parte

Existe uma diferença sutil, mas importante, entre uma data e uma duração. Uma data é um ponto no tempo: 2 de julho de 2026. Uma duração é um intervalo: 30 dias, sem começo nem fim definidos. O Python separa esses conceitos em tipos diferentes. A data é date ou datetime; a duração é timedelta. Você cria um timedelta dizendo quanto tempo ele representa, por exemplo timedelta(days=30) para trinta dias, e então soma ou subtrai esse intervalo de uma data.

from datetime import date, timedelta

hoje = date(2026, 7, 2)
uma_semana = timedelta(days=7)

futuro = hoje + uma_semana
passado = hoje - uma_semana

print(futuro)   # 2026-07-09  (7 dias depois)
print(passado)  # 2026-06-25  (7 dias antes)

# O Python cuida da virada de mes sozinho:
fim_do_mes = date(2026, 7, 31) + timedelta(days=1)
print(fim_do_mes)  # 2026-08-01

Somar ou subtrair um timedelta de uma data devolve outra data. A virada de mês é automática.

Repare no último exemplo: somar um dia a 31 de julho leva para 1 de agosto, sem que você precise saber que julho tem 31 dias. Esse é o grande ganho. O timedelta e o tipo de data cuidam de todas as regras chatas do calendário, incluindo meses de 28, 30 e 31 dias e até anos bissextos. Você pensa em dias; o Python pensa no resto. Além de days, o timedelta aceita weeks, hours, minutes e seconds, então dá para expressar quase qualquer intervalo.

Quantos dias entre duas datas

A operação mais útil talvez seja a inversa: você tem duas datas e quer saber quanto tempo há entre elas. Basta subtrair uma da outra. O resultado não é um número solto, e sim um timedelta, aquele tipo de duração. Para ler o total em dias, use o atributo .days do resultado. Se a primeira data for mais tarde que a segunda, o número de dias vem positivo; se for mais cedo, vem negativo. Isso é ótimo para calcular prazos, contagens regressivas e tempo decorrido.

from datetime import date

hoje = date(2026, 7, 2)
natal = date(2026, 12, 25)

faltam = natal - hoje       # isto e um timedelta
print(faltam)               # 176 days, 0:00:00
print(faltam.days)          # 176  (numero inteiro de dias)

print(f"Faltam {faltam.days} dias para o Natal.")
# Faltam 176 dias para o Natal.

# Ordem invertida da diferenca negativa:
print((hoje - natal).days)  # -176

Subtrair duas datas devolve um timedelta; .days extrai o total de dias como inteiro.

Calculando a idade em dias

Um exemplo clássico junta tudo: calcular há quantos dias uma pessoa nasceu. Você tem a data de nascimento e a data de hoje; a idade em dias é simplesmente a diferença entre as duas, lida com .days. Como today() dá a data atual, o cálculo se atualiza sozinho a cada dia que passa. Vale lembrar que idade em anos é mais delicada, porque depende de a pessoa já ter feito aniversário no ano corrente, mas idade em dias é direta e exata.

from datetime import date

nascimento = date(2000, 3, 15)
hoje = date(2026, 7, 2)

idade = hoje - nascimento
print(idade.days)   # 9606  (dias vividos ate 02/07/2026)

# Idade aproximada em anos (divisao inteira por 365):
anos = idade.days // 365
print(f"Cerca de {anos} anos de vida.")  # Cerca de 26 anos de vida.

# Proximo aniversario neste ano:
aniversario = date(hoje.year, nascimento.month, nascimento.day)
print(aniversario)  # 2026-03-15

Idade em dias é a diferença direta; dividir por 365 dá uma estimativa de anos.

A divisão inteira dos dias por 365 dá uma estimativa boa de anos, mas repare que é aproximada: ela ignora os anos bissextos, que têm 366 dias. Para a maioria dos usos do dia a dia, essa aproximação basta. Se você precisar da idade exata em anos, o caminho é comparar o mês e o dia de hoje com o mês e o dia do nascimento, subtraindo um ano quando a pessoa ainda não fez aniversário. Fica como um bom desafio para depois, mas o essencial desta aula é claro: com timedelta, contas de calendário deixam de ser um pesadelo.