Como calcular a diferença de tempo em Python

Ao trabalhar com datas e horas em Python, muitas vezes você precisará calcular a diferença de horário. Neste tutorial, você aprenderá a calcular a diferença entre dois timestamps em horas, minutos e segundos.

Ao final deste tutorial, você terá aprendido:

  • como usar o módulo datetime do Python para trabalhar com datas e horas,
  • o que são objetos timedelta e como eles são úteis, e
  • calcule a diferença de tempo entre quaisquer dois timestamps — em horas, minutos e segundos.

Vamos começar.

Como usar o módulo datetime do Python

Para trabalhar com datas e horas em Python, você usará o módulo datetime. O módulo datetime faz parte da biblioteca padrão do Python. Então você pode ir em frente e importá-lo para o seu ambiente de trabalho imediatamente, assim:

import datetime

Para calcular a diferença de tempo, você precisa criar dois timestamps diferentes. Você pode optar por criar:

  • dois objetos de data,
  • dois objetos de tempo, ou
  • uma combinação de data e hora — objetos datetime.

Como criar um objeto de data em Python

Vamos importar a classe date do módulo datetime. Para criar um objeto de data em Python, você pode usar a sintaxe geral datetime.date(,,). Aqui está um exemplo de criação de um objeto de data date1:

from datetime import date
date1 = datetime.date(2022,3,27)
print(date1)

# Output: 2022-03-27

Você pode tentar o código no compilador etechpt.com Python para testar. Ou instale o Python em seu computador.

Conforme mostrado acima, quando você imprime a data, ela é formatada no formato AAAA-MM-DD para datas.

Nota: Certifique-se de especificar o mês como um número inteiro sem zeros à esquerda. É provável que você esteja acostumado a adicionar um zero à esquerda ao mês ao escrever datas.

  Como bloquear um número no iPhone

Por exemplo, para especificar uma data em junho, o 6º mês do ano: use 6 e não 06.

Por exemplo, tente executar o seguinte trecho de código—onde o mês foi mencionado como 03 em vez de apenas 3. Você verá que ele lança um erro de sintaxe conforme mostrado:

date1 = datetime.date(2022,03,27)

print(date1)

# Error Message
File "<ipython-input-12-6eb72084e6ce>", line 1
    date1 = datetime.date(2022,03,27)
                                ^
SyntaxError: invalid token

Vamos ver agora como criar um objeto de tempo em Python.

Como criar um objeto de tempo em Python

Para criar um objeto de tempo, vamos importar a classe de tempo. Qualquer objeto de tempo do Python pode ser criado usando a classe de tempo especificando os seguintes atributos de classe: hora, minuto, segundo e microssegundo.

No entanto, todos esses atributos são opcionais. Se você não especificar um determinado atributo, digamos, segundo, ele será definido como 0 por padrão.

O trecho de código a seguir mostra como você pode criar um objeto de tempo time1. Assim como com o objeto de data, você pode imprimir o objeto de hora para ver a hora formatada.

from datetime import time
time1 = datetime.time(13,27,45,4600)
print(time1)

# Output: 13:27:45.004600

Como criar um objeto de data e hora em Python

Como você pode ver, o objeto de data não possui informações sobre a hora. E o objeto time não contém informações sobre a data.

No entanto, na prática, você precisará das informações de data e hora. Portanto, é recomendável usar a classe datetime.

Você pode acessar a classe datetime e criar objetos datetime em Python, conforme mostrado abaixo:

dt1 = datetime.datetime(2022,3,27,13,27,45,46000)
print(dt1)

# Output: 2022-03-27 13:27:45.046000

Vamos agora criar outro objeto datetime dt2 sem o segundo atributo. Você pode ver que está definido como 0 – o valor padrão.

dt2 = datetime.datetime(2022,6,30,14,28)
print(dt2)

# Output: 2022-06-30 14:28:00

Até agora, você aprendeu a criar carimbos de data/hora em Python — como datas, horas e datas. Agora é hora de ver como você pode calcular a diferença entre quaisquer dois timestamps.

  9 Melhor conclusão de código alimentada por IA para desenvolvimento produtivo

Vá para a próxima seção para descobrir.

Como usar o objeto timedelta em Python

Em Python, timedelta denota um intervalo de tempo. É a diferença entre dois objetos de data, hora ou data e hora.

Se você adicionar ou subtrair dois objetos de data, hora ou data e hora, obterá um objeto timedelta. Esse objeto timedelta possui atributos e métodos úteis que podem ajudar a calcular a diferença de horário.

Vamos em frente e calcular a diferença entre os dois objetos datetime dt1 e dt2.

dt1 = datetime.datetime(2022,3,27,13,27,45,46000) 
dt2 = datetime.datetime(2022,6,30,14,28) 
tdelta = dt2 - dt1 
print(tdelta) 
print(type(tdelta)) 

# Output 
95 days, 1:00:14.954000 
<class 'datetime.timedelta'>

A partir do trecho de código acima, você pode ver que a variável tdelta contém a diferença de tempo entre dt1 e dt2. E o tipo de tdelta é verificado para ser da classe timedelta usando o built-in do Python modelo() função.

Agora vamos codificar outro exemplo.

Como encontrar a diferença de tempo entre duas datas

Vamos dar um exemplo simples, mas interessante.

Problema: Para calcular a diferença de tempo entre a data atual (hoje) e seu aniversário.
Para fazer isso, defina hoje como o primeiro carimbo de data/hora e seu aniversário como o segundo carimbo de data/hora.

Como primeiro passo, vamos criar dois objetos datetime:

  • um para hoje, vamos chamá-lo hoje, e
  • outro para o seu aniversário, vamos chamá-lo de aniversário

A classe datetime tem o método now() que fornece a data e hora locais atuais. Então, vamos usá-lo para hoje – nossa data de referência.

today = datetime.datetime.now()
print(today)

# Sample Output: 2022-01-22 09:10:18.489538

No código abaixo, substitua bday por seu aniversário para calcular o tempo restante para seu aniversário este ano.

Se você estiver lendo isso depois que seu aniversário já tiver passado, sinta-se à vontade para definir o aniversário para o seu próximo aniversário.

bday = datetime.datetime(2022,8,30,11,59)
print(bday)

# Sample Output: 2022-08-30 11:59:00

O próximo passo é calcular time_diff que é um objeto timedleta, conforme explicado anteriormente. Basta subtrair hoje do seu aniversário e você terá a diferença de horário.

time_diff = bday - today
print(f"Your birthday is in {time_diff}")

# Output
Your birthday is in 220 days, 2:46:00.127416

Para saber o número de dias restantes, use o atributo days em time_diff, conforme mostrado:

tdays = time_diff.days
print(f"Your birthday is in {tdays} days.")

# Output
Your birthday is in 220 days.

Como encontrar a diferença de tempo em segundos

Vamos agora calcular quantos segundos faltam para o seu aniversário.

  O que acontece com o seu Smarthome quando acaba a energia?

Para calcular a diferença de tempo total em segundos, use o método total_seconds() no objeto timedelta time_diff.

tsecs = time_diff.total_seconds()
print(f"Your birthday is {tsecs} seconds away.")

# Output
Your birthday is 19017960.127416 seconds away.

Bem, isso é muito tempo de espera!

Dito isso, agora você sabe como calcular a diferença de tempo entre quaisquer dois timestamps em segundos.

Vamos agora revisitar alguns conceitos básicos e escrever o seguinte. Um dia é composto por 24 horas, uma hora tem 60 minutos e 60 segundos compõem um minuto.

Isso está resumido na imagem abaixo:

Horas, minutos e segundos

Portanto, para converter de segundos para minutos, horas e dias, você pode usar a tabela a seguir e dividir pelo fator de conversão correspondente.

Tabela de conversão de tempo

Nas próximas seções, vamos converter a diferença horária em segundos para minutos e horas.

Como encontrar a diferença de tempo em minutos

Para obter a diferença horária em minutos, basta dividir o total de segundos por 60.

Vamos dividir tsecs por 60 e armazená-lo em uma variável chamada tmins, assim:

tmins = tsecs/60
print(f"Your birthday is {tmins} minutes away.")

# Output
Your birthday is 316966.0021236 minutes away.

Como encontrar a diferença horária em horas

Agora que você calculou a diferença de tempo em minutos, você pode dividir isso por um fator de 60 para obter a diferença em horas. Ou você pode dividir o total de segundos por 60*60 = 3600.

thrs = tsecs/(60*60)
print(f"Your birthday is {thrs} hours away.")

# Output
Your birthday is 5282.76670206 hours away.

Então agora você aprendeu a calcular a diferença de tempo em qualquer unidade de sua escolha.

Conclusão

Neste tutorial, você aprendeu como:

  • crie e trabalhe com datas e horas usando o módulo datetime do Python,
  • use objetos timedelta para obter um intervalo de tempo, ou diferença de tempo, e
  • calcule a diferença horária em segundos, minutos e horas.

Espero que você tenha achado este tutorial útil. Agora que você sabe tudo sobre como calcular a diferença de tempo em Python, é hora de colocar suas habilidades em prática.

Boa aprendizagem e codificação!

Aprenda a escrever igual ou não igual ao código ou faça um jogo de cobra em python aqui.