Como Trabalhar com Tempo no Python – Biblioteca Datetime

Na aula de hoje eu quero te mostrar como trabalhar com tempo no Python utilizando a biblioteca datetime para te auxiliar nos seus projetos!

Para trabalhar com tempo no Python, use a biblioteca nativa datetime: basta escrever import datetime. Com ela você cria datas com datetime.date, pega data e hora atuais com datetime.datetime.now(), acessa ano, mês e dia, soma e subtrai períodos e converte datas em texto com strftime.

Caso prefira esse conteúdo no formato de vídeo-aula, assista ao vídeo abaixo ou acesse o nosso canal do YouTube!

O que você aprende neste vídeo

Resposta rápida: Aula ensina a biblioteca nativa datetime do Python para criar, formatar e comparar datas e horários, usando as classes date, time, datetime e timedelta. Mostra como criar uma data com datetime.date(), alterar um campo com replace() sem afetar a original, calcular a diferença entre datas com timedelta, e converter data em texto (e de volta) com strftime e strptime.

Neste vídeo (41 min):

  • 2:00 - Import da biblioteca nativa datetime, sem precisar instalar nada, podendo receber um apelido como dt
  • 4:00 - As quatro classes dentro de datetime: date (só data), time (só hora), datetime (data e hora) e timedelta (diferença de tempo)
  • 5:00 - Cria uma data com datetime.date(ano, mes, dia), por exemplo 14 de julho de 2021
  • 10:00 - Dia, mês e ano de uma data são atributos, acessados sem parênteses (data.day), porque não são uma ação
  • 11:00 - Tentar ler data.hour numa variável do tipo date dá erro, porque essa classe não tem hora
  • 12:00 - replace() cria uma data nova mudando só o campo indicado, sem alterar a data original
  • 13:00 - date.today() devolve a data atual do sistema
  • 15:00 - Subtrair a data de hoje pela data criada devolve um timedelta com o número de dias entre as duas
  • 17:00 - Somar esse timedelta a uma data projeta uma data futura
  • 25:00 - strftime converte a data para uma string no formato escolhido, usando códigos como %d, %m e %Y
  • 30:00 - strptime faz o caminho inverso: lê uma string formatada e devolve um objeto de data
  • 36:00 - Aplicação prática: registra comentários digitados numa lista, cada um com o horário formatado da publicação

Trechos do vídeo:

  • A biblioteca datetime é nativa do Python: basta import datetime, sem instalar nada
  • As classes date, time e timedelta lidam separadamente com data, hora e diferença de tempo, e datetime junta data e hora numa só estrutura
  • Subtrair duas datas do tipo date devolve um objeto timedelta, com o número de dias entre elas
  • O método replace() cria uma data nova a partir de outra, alterando só o campo indicado, sem modificar a data original
  • strftime converte uma data em texto num formato escolhido, e strptime faz o processo inverso, lendo um texto e devolvendo um objeto de data

Para receber por e-mail o(s) arquivo(s) utilizados na aula, preencha:

Trabalhando com Tempo no Python

Você sabia que é possível trabalhar com tempo utilizando a biblioteca Datetime no Python?

Hoje quero mostrar como você pode não só trabalhar com essas informações, mas como formatar a data, fazer operações entre datas, entre outras atividades!

Ícone PythonPython Impressionador

Você vai aprender a linguagem de Programação que mais cresce no Mundo para fazer automações incríveis, desenvolver sites, fazer análises de dados, trabalhar com Ciência de Dados, Inteligência Artificial, mesmo que você nunca tenha tido nenhum contato com Programação na vida.

Black Friday · Lote Especial · Lote 1 · Último Lote

De R$ 1.497 56% OFF54% OFF53% OFF

por 12x R$ 6467,5069

Preço do Lote Especial por tempo limitadoPreço do Lote Especial só até amanhã, 13/11, às 23h59Preço do Lote Especial até 13/11, às 23h59Último dia do Lote Especial: o preço vale até hoje, às 23h59Preço do Lote 1 por tempo limitadoPreço do Lote 1 só até amanhã, 20/11, às 23h59Preço do Lote 1 até 20/11, às 23h59Último dia do Lote 1: o preço vale até hoje, às 23h59Preço do Último Lote por tempo limitadoPreço do Último Lote só até amanhã, 27/11, às 23h59Preço do Último Lote até 27/11, às 23h59Último dia do Último Lote: o preço vale até hoje, às 23h59

Começar agoraQuero a oferta de Black FridaySeta para a direita
Fundo PythonTelas Python
Luz Python

Como Trabalhar com Tempo no Python

Como você deve saber, o primeiro passo é importar a biblioteca, visto que essa biblioteca é nativa do Python.

Python
import datetime # para importar toda a biblioteca
# import datetime as dt # substituindo o nome datetime por dt dentro do código
# from datetime import date # quando se quer apenas 1 dos submódulos

Aqui temos as principais classes que utilizarei na explicação.

OBS: Lembrando que o arquivo está disponível para download, mas você pode consultar a documentação da biblioteca, o que é sempre útil. Lembre-se de que recorrer à documentação para detalhes e aprofundamentos sobre a biblioteca ou o que estiver utilizando no Python.

Agora que você já sabe dessas informações podemos prosseguir!

Codigo
data = datetime.date(2021,9,25)
print(data)

print(data.ctime())

ano = data.year
mes = data.month
dia = data.day
#hora = data.hora # erro!
print(ano, mes, dia)

nova_data = data.replace(day=2)
print(nova_data)
print(data)
Métodos da biblioteca datetime

Aqui temos a formatação de data no Python (que é bem simples) e logo abaixo temos a alteração dessa formatação para um formato com tempo utilizando o ctime.

O acesso a uma informação é simples e intuitivo, como já deve ter visto em outros programas. Caso tenha conhecimento em inglês, fica ainda mais fácil.

A alteração é bem similar, mas utilizaremos o .replace + o que planejamos substituir. Lembrando que todas essas informações são em inglês, então não adianta escrever “dia”, “mês” ou “ano” dentro desses métodos.

Codigo
hoje = datetime.date.today()
print(hoje)

delta = hoje - data
print(delta)
print(type(delta))

nova_data = data + delta
print(nova_data)

hora = datetime.time

print(hora.hour)
print(hora.minute)
print(hora.second)
Métodos da biblioteca datetime

Agora apresento mais alguns métodos que também são tranquilos de entender e replicar.

O primeiro deles, talvez o mais utilizado, é o datetime.date.today(), dessa forma você consegue obter a data atual no Python.

Outro ponto interessante e provavelmente muito utilizado quando trabalhamos com datas são as operações.

É possível que façamos soma e subtração normalmente para verificamos o tempo de entre, tempo de espera, entre outras informações temporais.

Essa parte de operações com datas no Python é muito útil, principalmente quando estamos trabalhando com produtos, prazos de entrega, informações sobre produção, etc.

Nós vimos o datetime.date, mas temos também o datetime.time que permite formatar como tempo.

Então podemos obter hora, minuto e segundo da mesma maneira que conseguimos obter dia, mês e ano de uma data.

Assim você já sabe como acessar uma informação de data ou tempo quando precisar de uma informação específica.

Codigo
data = datetime.datetime(2021,11,12,11,15)
print(data)

agora = datetime.datetime.now()
print(agora)

agora_string = agora.strftime("%A %d %B %y %I:%M")
print(agora_string)

agora_datetime = datetime.datetime.strptime(agora_string,"%A %d %B %y %I:%M")
print(agora_datetime)
Como Trabalhar com Tempo no Python

Também é possível criarmos um data e um tempo, ou criarmos uma variável que tenha tanto a data quanto a hora.

Isso quer dizer que podemos ter as duas informações em uma única variável. E assim como pegamos a data atual, podemos pegar a hora.

Então além da data atual, você já vai ter a hora atual, o que é interessante para algumas aplicações que precisam de um detalhamento maior em relação ao tempo.

Após pegarmos a data e hora temos como exibir essas informações de uma maneira diferente utilizando texto (formato de string).

Isso é muito interessante para quando precisamos do texto completo e não somente a data. Veja que no arquivo que disponibilizei a documentação de como funciona essa parte.

Cada letra tem um significado e alterar entre maiúscula e minúscula faz diferença no resultado. Por exemplo, a letra A (em maiúsculo) mostra o nome do dia da semana.

Se utilizar maiúsculo nós temos o nome do dia completo, caso utilizemos minúsculo teremos o nome do dia abreviado.

Nessa documentação tem uma série de informações que podem ser úteis para suas aplicações, então vale a pena dar uma olhada, pois vão te auxiliar!

Codigo
comentarios = []

comentario = None
while comentario != "":
	comentario = input('Insira seu comentário')
	data_public = datetime.datetime.now()
	data_public_str = data_public.strftime("%d/%m/%Y %H:%M")
	comentarios.append((comentario,data_public_str))

for comentario in comentarios[:-1]:
	print(comentario)
Como Trabalhar com Tempo no Python
Aplicação prática

Para finalizar temos um pequeno código para utilizar o que aprendemos na aula de hoje, então proponho que utilizemos as estruturas de repetição while e for.

Utilizaremos a estrutura while para pegar o comentário do usuário e em seguida guardá-lo com a hora em que foi feito.

Assim, não havendo nada escrito e o usuário pressionar enter, partiremos para a estrutura de repetição for.

Essa estrutura vai apenas fazer um print de tudo o que foi armazenado durante a fase dos comentários.

Então, enquanto o comentário diferir de vazio, o Python guardará o que for registrado e vai armazenará a hora em que isso foi feito.

Quer saber mais sobre como trabalhar com tempo no Python? Conheça o curso online completo de Python da Hashtag Treinamentos!

Perguntas frequentes

1. Como pegar a data e a hora atual no Python?

Use datetime.date.today() quando precisar apenas da data e datetime.datetime.now() quando quiser data e hora juntas na mesma variável. Também dá para acessar as partes separadamente, com .year, .month e .day para a data e .hour, .minute e .second para o horário.

2. Como calcular a diferença entre duas datas no Python?

Basta subtrair uma data da outra: o resultado é um objeto timedelta, que traz a diferença em dias. Esse mesmo objeto pode ser somado a outra data para descobrir um vencimento ou prazo de entrega, o que ajuda em controles de produção, cobrança e logística.

3. Como formatar uma data no Python com strftime?

O método strftime transforma a data em texto seguindo um modelo, como “%d/%m/%Y %H:%M”. Cada letra representa uma parte da data e maiúsculas e minúsculas mudam o resultado: %A traz o dia da semana por extenso e %a a versão abreviada. O caminho inverso é o strptime.

4. Preciso instalar a biblioteca datetime no Python?

Não. A datetime é nativa, ou seja, já vem com o Python e não exige instalação por pip. Você só precisa importá-la no início do código, com import datetime, import datetime as dt ou trazendo apenas um submódulo, como from datetime import date.

Conclusão

Nessa aula eu te mostrei como você trabalha com tempo dentro do Python. Não é nada complexo, mas saber um pouco de inglês facilita na hora de escrever os códigos.

Isso não é necessário, mas te ajuda se souber, até porque boa parte das documentações que vamos encontrar estão em inglês. Mesmo que não saiba, é possível traduzi-las, conseguindo utilizá-las com tranquilidade.

Hashtag Treinamentos

Para acessar outras publicações de Python, clique aqui!


Quer aprender mais sobre Python com um minicurso básico gratuito?