Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

Ler uma data a partir de texto e combiná-la com uma hora em Python

`strptime()` lê texto de acordo com um formato indicado e devolve um `datetime`. Usa `.date()` para extrair a data e `combine()` para a juntar a uma hora indicada separadamente.

Versão: Python 3.12

Sintaxe

from datetime import datetime, time

parsed = datetime.strptime(date_string, format)
calendar_date = parsed.date()
combined = datetime.combine(calendar_date, time(hour, minute))

Em Python 3.12, datetime.datetime.strptime é um método de classe da classe datetime do módulo datetime. Depois de from datetime import datetime, chama datetime.strptime(date_string, format). O formato indica como ler o texto: em %d/%m/%Y, as diretivas representam o dia do mês, o mês e o ano com quatro algarismos; as barras são literais. Com %d/%m/%Y, o método lança ValueError se o texto não corresponder ao formato ou se o dia, o mês e o ano não formarem uma data válida.

O resultado é um datetime, mesmo que o texto só contenha uma data. Os campos em falta são preenchidos a partir de 1900-01-01T00:00:00, pelo que uma data completa sem hora dá a meia-noite. Não é possível ler 29 de fevereiro sem ano, porque 1900 não foi bissexto. Ao contrário de %B, as diretivas numéricas do exemplo não dependem dos nomes dos meses das definições regionais. Sem %z, o resultado não tem informação de fuso horário (é ingénuo e tzinfo é None); %z lê um desvio em relação a UTC e devolve um objeto com informação de fuso horário e desvio fixo.

parsed.date() é um método de instância. Devolve um objeto date com o mesmo ano, mês e dia, mas sem hora nem informação de fuso horário. Não altera parsed.

datetime.combine(calendar_date, time(14, 30)) chama um método de classe que cria um novo datetime a partir da data e do objeto time fornecidos. O resultado recebe tzinfo do objeto time, a menos que passes tzinfo explicitamente. Se o primeiro argumento for um datetime, a sua hora e o seu tzinfo são ignorados. combine() não lê texto nem converte horas entre fusos horários.

Exemplos

from datetime import datetime, time

parsed = datetime.strptime("29/02/2024", "%d/%m/%Y")
calendar_date = parsed.date()
combined = datetime.combine(calendar_date, time(14, 30))

print(parsed.isoformat())
print(calendar_date.isoformat())
print(combined.isoformat())

Resultado

2024-02-29T00:00:00
2024-02-29
2024-02-29T14:30:00

As três linhas mostram a data lida com a hora a indicar meia-noite, apenas a data e a mesma data às `14:30:00`. O método `isoformat()` serve apenas para apresentar os valores.

Lições relacionadas

  • Python · Lição 31 · Intermédio · Versão: 3

Fontes