Python: Aprenda a usar a biblioteca timedelta para manipular datas
A biblioteca timedelta do Python é uma poderosa ferramenta para manipular datas e horários.
Glossário
O que é a biblioteca timedelta do Python?
A biblioteca timedelta do Python é uma poderosa ferramenta que permite manipular datas e horários de forma simples e eficiente. Ela faz parte do módulo datetime do Python e oferece uma série de métodos e funcionalidades para realizar operações com datas, como adicionar ou subtrair intervalos de tempo, calcular diferenças entre datas, entre outros.
Como utilizar a biblioteca timedelta para manipular datas em Python?
1. Adicionar ou subtrair intervalos de tempo:
Para adicionar um intervalo de tempo a uma data ou horário específico, basta criar um objeto timedelta com o valor desejado e somá-lo à data ou horário desejado. Por exemplo:
from datetime import datetime, timedelta
data = datetime(2022, 1, 1)
intervalo = timedelta(days=7)
nova_data = data + intervalo
Nesse exemplo, estamos adicionando um intervalo de 7 dias à data especificada. O resultado será uma nova data correspondente a uma semana após a data original.
Da mesma forma, é possível subtrair um intervalo de tempo de uma data ou horário específico. Basta criar um objeto timedelta com o valor desejado e subtraí-lo da data ou horário desejado. Por exemplo:



from datetime import datetime, timedelta
data = datetime(2022, 1, 1)
intervalo = timedelta(days=7)
nova_data = data - intervalo
Nesse caso, estamos subtraindo um intervalo de 7 dias da data especificada. O resultado será uma nova data correspondente a uma semana antes da data original.
2. Calcular diferenças entre datas:
A biblioteca timedelta também permite calcular a diferença entre duas datas ou horários. Para isso, basta subtrair uma data da outra. O resultado será um objeto timedelta representando o intervalo de tempo entre as duas datas. Por exemplo:
from datetime import datetime
data1 = datetime(2022, 1, 1)
data2 = datetime(2022, 1, 10)
diferenca = data2 - data1
print(f"A diferença entre as datas é de {diferenca.days} dias.")
Nesse exemplo, estamos calculando a diferença entre duas datas e exibindo o resultado em dias.
3. Trabalhar com intervalos de tempo específicos:
Além de adicionar ou subtrair intervalos de tempo genéricos, a biblioteca timedelta também permite trabalhar com intervalos de tempo específicos, como horas, minutos, segundos, etc. Por exemplo:
from datetime import datetime, timedelta
hora_atual = datetime.now().time()
intervalo = timedelta(hours=1, minutes=30)
nova_hora = (datetime.combine(datetime.today(), hora_atual) + intervalo).time()
Nesse caso, estamos adicionando um intervalo de 1 hora e 30 minutos à hora atual. O resultado será uma nova hora correspondente ao horário atual mais uma hora e meia.
Principais métodos da biblioteca timedelta
A biblioteca timedelta do Python possui uma série de métodos que permitem realizar operações avançadas com datas. Alguns dos principais métodos incluem:
- total_seconds(): Retorna o total de segundos representados pelo objeto timedelta.
- days: Retorna o número de dias do objeto timedelta.
- seconds: Retorna o número de segundos restantes após retirar os dias do objeto timedelta.
- microseconds: Retorna o número de microssegundos restantes após retirar os dias e segundos do objeto timedelta.
Esses são apenas alguns exemplos dos métodos disponíveis na biblioteca timedelta. Para conhecer todos os métodos e suas funcionalidades, consulte a documentação oficial do Python.
Exemplos de uso da biblioteca timedelta em Python
Agora que já conhecemos os conceitos básicos e principais funcionalidades da biblioteca timedelta, vamos ver alguns exemplos práticos de uso:



Exemplo 1: Calcular a data de vencimento de uma fatura a partir da data de emissão e do prazo de pagamento.
from datetime import datetime, timedelta
data_emissao = datetime(2022, 1, 1)
prazo_pagamento = timedelta(days=15)
data_vencimento = data_emissao + prazo_pagamento
print(f"A fatura vencerá em {data_vencimento.strftime('%d/%m/%Y')}.")
Nesse exemplo, estamos adicionando um prazo de 15 dias à data de emissão de uma fatura para calcular a data de vencimento.
Exemplo 2: Verificar se um evento está prestes a ocorrer com base na data e hora atual.
from datetime import datetime, timedelta
data_evento = datetime(2022, 12, 31, 23, 59, 59)
tempo_restante = data_evento - datetime.now()
if tempo_restante < timedelta(days=7):
print("O evento está prestes a ocorrer!")
else:
print("Ainda falta um tempo para o evento.")
Nesse exemplo, estamos calculando o tempo restante para um evento com base na data e hora atual. Se o tempo restante for menor que 7 dias, significa que o evento está prestes a ocorrer.
Conclusão
A biblioteca timedelta do Python é uma ferramenta poderosa e versátil para manipular datas e horários. Com ela, é possível realizar uma infinidade de operações, desde adicionar ou subtrair intervalos de tempo até calcular diferenças entre datas. Se você trabalha com datas em seus projetos Python, aprender a utilizar a biblioteca timedelta é essencial.
Python: Aprenda a usar a biblioteca timedelta para manipular datas. Através deste artigo, você conheceu os conceitos básicos da biblioteca timedelta, aprendeu como utilizá-la para manipular datas em Python e viu exemplos práticos de uso. Agora é hora de colocar em prática e explorar ainda mais as funcionalidades dessa poderosa ferramenta.
A Awari é a melhor plataforma para aprender sobre ciência de dados no Brasil.
Aqui você encontra cursos com aulas ao vivo, mentorias individuais com os melhores profissionais do mercado e suporte de carreira personalizado para dar seu próximo passo profissional e aprender habilidades como Data Science, Data Analytics, Machine Learning e mais.
Já pensou em aprender de maneira individualizada com profissionais que atuam em empresas como Nubank, Amazon e Google? Clique aqui para se inscrever na Awari e começar a construir agora mesmo o próximo capítulo da sua carreira em dados.


