CKTIS / Python
Python `date`: interpretar, extrair e combinar uma data com uma hora
Em Python 3.12, `strptime()` devolve um `datetime`, `.date()` extrai a data e `combine()` junta-a a uma hora escolhida.
Versão: Python 3.12
Sintaxe
from datetime import date, datetime, time
calendar_day = date(year, month, day)
parsed = datetime.strptime(text, format_string)
calendar_day = parsed.date()
combined = datetime.combine(calendar_day, clock_time)
combined = datetime.combine(calendar_day, clock_time, tzinfo=zone)Em Python 3.12, datetime.date é uma classe imutável do módulo datetime. Um objeto date guarda o ano, o mês e o dia, sem hora nem fuso horário. Após from datetime import date, date(year, month, day) constrói uma data a partir de três inteiros. Se os argumentos couberem num int de C, uma data inválida como 29 de fevereiro de 2023 provoca ValueError. Em CPython 3.12, um inteiro que não possa ser convertido num int de C, como o ano em date(10**100, 1, 1), provoca OverflowError antes da validação da data.
Após from datetime import datetime, o nome datetime refere-se à classe datetime.datetime, não ao módulo. O método de classe datetime.strptime(text, format_string) interpreta o texto segundo o formato indicado e devolve um datetime, mesmo que o texto só contenha uma data. Em %d/%m/%Y, as barras separam o dia, o mês e o ano de quatro algarismos. Se não for indicada uma hora, o resultado tem a hora 00:00:00. Um texto que não corresponde ao formato ou uma data inválida provocam ValueError. A classe date não tem um método strptime() em Python 3.12.
O método de instância parsed.date() devolve um date com o mesmo ano, mês e dia. Não altera parsed, não conserva a hora nem o fuso horário e não converte entre fusos horários. Ao contrário deste método, o construtor date(year, month, day) recebe os componentes da data em separado.
O método de classe datetime.combine(calendar_day, clock_time) cria um novo datetime a partir de uma data e de um objeto datetime.time, não de uma cadeia de caracteres. Por predefinição, usa o tzinfo do objeto time; um argumento explícito tzinfo=zone substitui esse valor sem converter a hora. Se o primeiro argumento for um datetime, a sua hora e o seu tzinfo são ignorados.
Exemplos
from datetime import date, datetime, time
parsed = datetime.strptime("29/02/2024", "%d/%m/%Y")
calendar_day = parsed.date()
assert type(calendar_day) is date
combined = datetime.combine(calendar_day, time(14, 30))
print(parsed.isoformat())
print(calendar_day.isoformat())
print(combined.isoformat())Resultado
2024-02-29T00:00:00 2024-02-29 2024-02-29T14:30:00
A primeira linha mostra a meia-noite após a leitura de uma data sem hora, a segunda mostra apenas a data e a terceira mostra a mesma data às 14:30 sem fuso horário.
Lições relacionadas
- Python · Lição 31 · Intermédio · Versão: 3