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

CKTIS / Python

Combinar uma data e uma hora com datetime.combine()

Interpreta uma data em texto com `strptime()`, extrai-a com `.date()` e combina-a com uma hora indicada à parte através de `datetime.combine()`.

Versão: Python 3.12

Sintaxe

from datetime import datetime, time

parsed = datetime.strptime(date_string, format)
day = parsed.date()
result = datetime.combine(day, time(hour, minute))

# Optional: override the time object's tzinfo.
result = datetime.combine(day, time(hour, minute), tzinfo=zone)

Em Python 3.12, após from datetime import datetime, time, datetime designa a classe do módulo com o mesmo nome. O método de classe datetime.strptime(texto, formato) devolve um datetime, e não um date, mesmo quando o texto só contém uma data. Com %d/%m/%Y, a hora é 00:00:00 por omissão. Se o texto não corresponder ao formato ou indicar uma data inválida, o método lança ValueError.

O método de instância parsed.date() devolve um date com o mesmo ano, mês e dia, sem hora nem informação de fuso horário. O método de classe datetime.combine(day, time(14, 30)) cria um novo datetime com a data de day e a hora do objeto time. Também podes usar um datetime como primeiro argumento, mas a respetiva hora e o respetivo tzinfo são ignorados. A chamada a .date() deixa claro que só precisas da data.

Se omitires tzinfo, combine usa o do objeto time. Um tzinfo explícito tem prioridade; tzinfo=None produz um resultado sem informação de fuso horário. Definir tzinfo não converte a hora para outro fuso.

Exemplos

from datetime import datetime, time

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

print(parsed.isoformat())
print(day.isoformat())
print(appointment.isoformat())

Resultado

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

A primeira linha mostra o valor interpretado à meia-noite, a segunda mostra apenas a data e a terceira mostra a mesma data às 14:30, sem informação de fuso horário.

Lições relacionadas

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

Fontes