Trabalhando com datas: datetime em visão geral

A data e a hora de agora

Quase todo programa precisa lidar com o tempo em algum momento: registrar quando algo aconteceu, calcular um prazo, descobrir a idade de alguém. Guardar isso como texto, tipo "25/12/2026", é uma armadilha, porque você não consegue comparar nem calcular com texto de forma confiável. O módulo datetime resolve isso com objetos de data que sabem fazer contas. O ponto de partida é a função now, que devolve o instante atual.

from datetime import datetime

agora = datetime.now()
print(agora)          # 2026-07-02 14:30:05.123456

# partes acessiveis por atributo
print(agora.year)     # 2026
print(agora.month)    # 7
print(agora.day)      # 2
print(agora.hour)     # 14

datetime.now() devolve o instante atual, com ano, mês, dia e hora acessíveis por atributo.

Repare no import diferente: from datetime import datetime. O nome do módulo e o nome da classe principal dentro dele são iguais, datetime, o que confunde no começo. A leitura é: do módulo datetime, traga a classe datetime. A partir daí, datetime.now() devolve o momento atual e você acessa cada parte por atributo, como .year e .day. Nada de fatiar texto: os pedaços já vêm prontos e corretos.

Criar uma data e comparar

Além de pegar o agora, você quase sempre precisa criar uma data específica, como um prazo ou um feriado. Basta informar ano, mês e dia, nessa ordem. E como esses objetos entendem o calendário de verdade, você pode compará-los com os operadores que já conhece do Básico: maior, menor, igual. Perguntar se uma data vem antes de outra é tão simples quanto comparar dois números.

from datetime import datetime

natal = datetime(2026, 12, 25)
hoje = datetime.now()

print(natal > hoje)   # True, se ainda nao chegou o Natal

if hoje < natal:
    print("O Natal ainda nao chegou.")
else:
    print("O Natal ja passou este ano.")

Objetos de data se comparam com <, > e == como se fossem números.

A diferença entre duas datas

O cálculo mais pedido com datas é a diferença: quantos dias faltam para um prazo, há quanto tempo algo aconteceu, quantos dias uma pessoa já viveu. No datetime isso é uma subtração direta. Quando você subtrai uma data de outra, o Python não devolve um número solto: ele devolve um objeto timedelta, que representa uma duração. Desse timedelta você tira a quantidade de dias com o atributo .days.

from datetime import date

ano_novo = date(2027, 1, 1)
hoje = date.today()

faltam = ano_novo - hoje   # isto e um timedelta
print(faltam.days, "dias para o Ano Novo")
# ex.: 183 dias para o Ano Novo

nascimento = date(1990, 5, 20)
vividos = hoje - nascimento
print(f"Voce ja viveu {vividos.days} dias")

Subtrair datas devolve um timedelta; .days dá a diferença em dias.

Essa visão geral já resolve muita coisa do dia a dia: pegar o agora, criar datas, compará-las e medir a distância entre elas. O que fica para o módulo 14 é o refinamento: formatar uma data para exibir no jeito brasileiro, ler uma data que veio como texto, somar dias a uma data e lidar com fuso horário. Por ora, você tem o essencial para não guardar mais datas como texto solto e para deixar o Python fazer as contas de calendário por você, sem erro.