WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Python `date`: Datum einlesen, extrahieren und mit einer Uhrzeit verbinden

In Python 3.12 liefert `strptime()` ein `datetime`, `.date()` extrahiert das Kalenderdatum und `combine()` verbindet es mit einer gewählten Uhrzeit.

Version: Python 3.12

Syntax

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)

In Python 3.12 ist datetime.date eine unveränderliche Klasse im Modul datetime. Ein date-Objekt speichert Jahr, Monat und Tag, aber weder Uhrzeit noch Zeitzone. Nach from datetime import date erzeugt date(year, month, day) ein Datum aus drei Ganzzahlen. Liegen die Argumente im Wertebereich des C-Typs int, löst ein ungültiges Kalenderdatum wie der 29. Februar 2023 ValueError aus. Lässt sich eine Ganzzahl nicht in den C-Typ int umwandeln, wie etwa das Jahr in date(10**100, 1, 1), löst CPython 3.12 schon vor der Prüfung des Kalenderdatums OverflowError aus.

Nach from datetime import datetime bezeichnet datetime die Klasse datetime.datetime, nicht das Modul. Die Klassenmethode datetime.strptime(text, format_string) liest Text im angegebenen Format ein und gibt ein datetime zurück, auch wenn der Text nur ein Datum enthält. In %d/%m/%Y trennen Schrägstriche Tag, Monat und vierstelliges Jahr. Ohne Zeitangabe ist die Uhrzeit im Ergebnis 00:00:00. Text im falschen Format oder ein ungültiges Datum löst ValueError aus. Die Klasse date hat in Python 3.12 keine Methode strptime().

Die Instanzmethode parsed.date() gibt ein date mit demselben Jahr, Monat und Tag zurück. Sie ändert parsed nicht, übernimmt weder Uhrzeit noch Zeitzone und rechnet nicht in eine andere Zeitzone um. Anders als diese Methode erwartet der Konstruktor date(year, month, day) die Datumskomponenten einzeln.

Die Klassenmethode datetime.combine(calendar_day, clock_time) erzeugt ein neues datetime aus einem Datum und einem datetime.time-Objekt, nicht aus einer Zeichenkette. Standardmäßig übernimmt sie tzinfo vom time-Objekt. Ein explizites tzinfo=zone überschreibt diesen Wert, ohne die Uhrzeit umzurechnen. Ist das erste Argument ein datetime, werden dessen Uhrzeit und tzinfo ignoriert.

Beispiele

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())

Ergebnis

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

Die erste Zeile zeigt Mitternacht nach dem Einlesen eines reinen Datums, die zweite nur das Datum und die dritte dasselbe Datum um 14:30 ohne Zeitzone.

Zugehörige Lektionen

  • Python · Lektion 31 · Mittlere Stufe · Version: 3

Quellen