HOWTO · Python

Comparar Duas Datas em Python

Este tutorial demonstra como duas datas podem ser comparadas e verifica qual a data que é maior em Python.

Nesta página

Use os operadores de comparação do Python quando dois valores tiverem tipos compatíveis. Uma comparação entre date ordena dias do calendário; uma comparação entre datetime também considera o horário. Não é possível ordenar diretamente um date e um datetime: compare valores do mesmo tipo ou converta deliberadamente ambos para uma representação comum. Analise as strings antes de compará-las e subtraia valores de data e hora quando precisar calcular um intervalo decorrido. Em um sistema de reservas, por exemplo, compare as datas solicitadas e reservadas para identificar a ordem ou possíveis conflitos.

Compare objetos date com operadores de comparação

Importe a classe date do módulo datetime para comparar datas do calendário sem considerar o horário. Os operadores <, >, <=, >=, == e != comparam ano, mês e dia em ordem cronológica. Por exemplo, 29 de junho é posterior a 9 de junho; a expressão booleana pede ao Python que verifique essa ordem.

Execute este exemplo:

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

from datetime import date

start = date(2023, 6, 9)
end = date(2023, 6, 29)
print(end > start)
True

O exemplo exibe True (rótulo em inglês, mantido sem tradução), indicando que 29 de junho é posterior a 9 de junho. Use date quando apenas o dia do calendário importar, como para verificar se o prazo de vencimento já passou. Os dois operandos devem ser valores date. Não ordene diretamente um date em relação a um datetime; o Python exige tipos de operandos compatíveis para fazer essa comparação. Compare valores do mesmo tipo ou converta deliberadamente ambos para uma representação comum. Uma string como "2023-06-29" não é convertida automaticamente durante a comparação.

Compare objetos datetime quando o horário importar

Use a classe datetime quando o horário do dia precisar afetar o resultado. A comparação inclui os campos de data e hora, então dois valores do mesmo dia do calendário ainda podem ser ordenados pela hora, pelos minutos e por unidades menores. Os valores a seguir são do mesmo dia, mas 16h30 é posterior a 9h.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

from datetime import datetime

morning = datetime(2023, 6, 29, 9, 0)
afternoon = datetime(2023, 6, 29, 16, 30)
print(afternoon > morning)
True

O exemplo exibe True (rótulo em inglês, mantido sem tradução). Valores datetime ingênuos, ou seja, sem informações de fuso horário, podem ser comparados com outros valores ingênuos. Para valores com fuso horário, use informações de fuso compatíveis. O Python não permite ordenar um datetime ingênuo em relação a um valor com fuso horário; normalize os valores segundo uma política de fuso horário comum antes de compará-los. Prefira date quando horários diferentes no mesmo dia devam ser considerados iguais.

Analise strings de datas com time.strptime()

Datas em texto precisam ter um formato conhecido antes da comparação. A função time.strptime() analisa uma string de acordo com um formato e retorna um struct_time; depois, esses valores podem ser comparados em ordem cronológica. O formato abaixo corresponde a entradas no padrão dia/mês/ano, portanto %d/%m/%Y interpreta 30/11/2020 como 30 de novembro de 2020.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

import time

first_text = "30/11/2020"
second_text = "12/10/2019"
first_date = time.strptime(first_text, "%d/%m/%Y")
second_date = time.strptime(second_text, "%d/%m/%Y")
print(first_date > second_date)
True

O exemplo exibe True (rótulo em inglês, mantido sem tradução): a primeira data analisada é posterior à segunda, de acordo com os campos de ano, mês e dia. Faça a string de formato corresponder exatamente à entrada: %m/%d/%Y indicaria uma ordem diferente. Não compare strings de datas diretamente para determinar a ordem cronológica, pois a ordem dos caracteres pode não corresponder à ordem do calendário. Se a entrada puder variar ou precisar de tratamento de fuso horário, analise-a para uma representação datetime adequada.

Use timedelta para comparar intervalos entre datas

Subtrair um date de outro, ou um datetime compatível de outro, produz um timedelta. Esse resultado é um intervalo decorrido, não uma data. Compare-o com outro timedelta quando quiser saber se já passou tempo suficiente; use operadores de comparação nas datas originais quando quiser saber qual delas vem primeiro.

O código e os rótulos ou saídas exibidos nesta seção permanecem em inglês.

from datetime import date, timedelta

start = date(2023, 6, 9)
end = date(2023, 6, 29)
elapsed = end - start
print(elapsed > timedelta(days=7))
True

O exemplo exibe True (rótulo em inglês, mantido sem tradução). A subtração produz um intervalo de 20 dias, maior que o limite de sete dias. timedelta aceita unidades como dias, segundos, minutos, horas e semanas; representa uma duração e não leva em conta meses ou anos do calendário, cujos comprimentos variam. Para calcular um intervalo entre valores datetime, garanta que ambos sigam as mesmas regras de consciência de fuso horário e de fuso horário antes de subtraí-los.