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
- datetime — Basic date and time types — datetime.strptime()
- datetime — Basic date and time types — datetime.date() instance method
- datetime — Basic date and time types — datetime.combine()
- datetime — Basic date and time types — strftime() and strptime() Behavior
- datetime — Basic date and time types — datetime.isoformat()
- datetime — Basic date and time types — date.isoformat()