Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

Python `date`: parsowanie, wyodrębnianie daty i łączenie jej z godziną

W Pythonie 3.12 `strptime()` zwraca `datetime`, `.date()` wyodrębnia samą datę, a `combine()` łączy ją z wybraną godziną.

Wersja: Python 3.12

Składnia

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)

W Pythonie 3.12 datetime.date to niemutowalna klasa z modułu datetime. Jej obiekty przechowują rok, miesiąc i dzień bez godziny ani strefy czasowej. Po from datetime import date wywołanie date(year, month, day) tworzy datę z trzech liczb całkowitych. Gdy składniki daty mieszczą się w zakresie typu int języka C, nieprawidłowa data, taka jak 29 lutego 2023 roku, powoduje ValueError. W CPythonie 3.12 liczba całkowita, której nie można przekonwertować na typ int języka C, jak rok w date(10**100, 1, 1), powoduje OverflowError jeszcze przed sprawdzeniem poprawności daty.

Po from datetime import datetime nazwa datetime oznacza klasę datetime.datetime, a nie moduł. Metoda klasowa datetime.strptime(text, format_string) odczytuje tekst według podanego formatu i zwraca obiekt datetime, nawet jeśli tekst zawiera tylko datę. Format %d/%m/%Y oznacza dzień, miesiąc i czterocyfrowy rok, rozdzielone ukośnikami. Bez podanej godziny wynik ma godzinę 00:00:00. Niezgodność tekstu z formatem lub nieprawidłowa data powodują ValueError. W Pythonie 3.12 klasa date nie ma metody strptime().

Metoda instancji parsed.date() zwraca obiekt date z tym samym rokiem, miesiącem i dniem. Nie zmienia parsed, nie przenosi godziny ani informacji o strefie i nie wykonuje konwersji strefy czasowej. To co innego niż konstruktor date(year, month, day), któremu przekazuje się składniki daty osobno.

Metoda klasowa datetime.combine(calendar_day, clock_time) tworzy nowy datetime z daty i obiektu datetime.time, nie ze stringa. Domyślnie bierze tzinfo z obiektu time; jawne tzinfo=zone zastępuje tę wartość bez przeliczania godziny. Jeśli pierwszym argumentem jest datetime, jego godzina i tzinfo są pomijane.

Przykłady

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

Wynik

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

Pierwszy wiersz pokazuje północ po parsowaniu samej daty, drugi samą datę, a trzeci tę samą datę z godziną 14:30 bez strefy czasowej.

Powiązane lekcje

  • Python · Lekcja 31 · Średniozaawansowany · Wersja: 3

Źródła