datetime w Pythonie: daty, godziny, timedelta i strefy czasowe

Dwa podstawowe typy: date i datetime

Moduł datetime daje cztery rzeczy, które warto znać: date, time, datetime i timedelta. Trzy pierwsze to to, na co wskazują nazwy, a czwarta to odcinek czasu.

from datetime import date, datetime, timedelta

today = date.today()
now = datetime.now()

print(today)
print(now)
print(type(today), type(now))

date reprezentuje dzień (rok, miesiąc, dzień) bez zegara. datetime to data plus godzina. Jeśli zegar nie jest potrzebny, date jest schludniejszym wyborem.

Tworzenie konkretnych dat

Utwórz je bezpośrednio:

from datetime import date, datetime

launch = date(2026, 1, 15)
meeting = datetime(2026, 1, 15, 14, 30)

print(launch)
print(meeting)

Argumenty to year, month, day dla date i maksymalnie year, month, day, hour, minute, second, microsecond dla datetime.

Odczyt pól

Każdy obiekt date/datetime ma atrybuty:

from datetime import datetime

now = datetime(2026, 4, 20, 9, 30, 15)

print(now.year, now.month, now.day)
print(now.hour, now.minute, now.second)
print(now.weekday())        # 0 = Monday, 6 = Sunday
print(now.isoweekday())     # 1 = Monday, 7 = Sunday
print(now.isoformat())

isoformat() to twój sprzymierzeniec przy wyjściu czytelnym dla maszyn: daje coś w stylu "2026-04-20T09:30:15", co inne systemy mogą sparsować bez dwuznaczności.

Formatowanie przez strftime

Dla wyjścia czytelnego dla ludzi .strftime(fmt) zamienia date albo datetime w sformatowany napis:

from datetime import datetime

now = datetime(2026, 4, 20, 9, 30)

print(now.strftime("%Y-%m-%d"))          # 2026-04-20
print(now.strftime("%d %B %Y"))          # 20 April 2026
print(now.strftime("%I:%M %p"))          # 09:30 AM
print(now.strftime("%A, %d %b"))         # Monday, 20 Apr

Kody formatu, które najczęściej warto pamiętać:

• %Y: rok czterocyfrowy (2026)
• %m: numer miesiąca z zerem wiodącym (04)
• %d: dzień miesiąca z zerem wiodącym (20)
• %H / %I: godzina w formacie 24- lub 12-godzinnym
• %M: minuta
• %S: sekunda
• %A / %a: nazwa dnia tygodnia pełna / skrócona (Monday / Mon)
• %B / %b: nazwa miesiąca pełna / skrócona (April / Apr)
• %p: AM/PM

Nie musisz ich zapamiętywać: zapisz sobie ściągę i zaglądaj do niej, gdy trzeba.

Parsowanie przez strptime

W drugą stronę: weź napis o znanym kształcie i zamień go na datetime:

from datetime import datetime

text = "2026-04-20 09:30"
parsed = datetime.strptime(text, "%Y-%m-%d %H:%M")

print(parsed)
print(parsed.year, parsed.hour)

Napis formatu musi dokładnie pasować do wejścia. Jeśli nie pasuje, strptime zgłasza ValueError.

Dla napisów ISO-8601 (standard czytelny dla maszyn) współczesny Python ma prostszy skrót:

from datetime import datetime

d = datetime.fromisoformat("2026-04-20T09:30:00")
print(d)

Jeśli masz do czynienia z przypadkowymi formatami, zewnętrzny pakiet dateutil (pip install python-dateutil) ma wyrozumiałe parser.parse(), które rozsądnie zgaduje.

Arytmetyka z timedelta

Do obliczeń na datach używaj timedelta jako różnicy albo przesunięcia:

from datetime import date, datetime, timedelta

today = date(2026, 4, 20)
next_week = today + timedelta(days=7)
yesterday = today - timedelta(days=1)

print(next_week, yesterday)

# Odjęcie dwóch dat daje timedelta.
gap = date(2027, 1, 1) - today
print(gap)
print(gap.days)

Argumenty timedelta: days, seconds, microseconds, milliseconds, minutes, hours, weeks. Nie ma months ani years, bo miesiące mają różną długość. Do obliczeń na miesiącach i latach użyj dateutil.relativedelta:

from dateutil.relativedelta import relativedelta
from datetime import date

today = date.today()
next_quarter = today + relativedelta(months=3)
print(next_quarter)

Strefy czasowe: naiwne i świadome

datetime bez informacji o strefie czasowej jest naiwny (naive): Python nie wie, jaką strefę reprezentuje. Obliczenia na naiwnych datach są w porządku, dopóki pozostajesz w jednej logicznej strefie. Kłopoty zaczynają się w chwili, gdy spotykają się dane z różnych stref.

Świadomy (aware) datetime niesie ze sobą informację o strefie. Dołącz strefę jawnie:

from datetime import datetime, timezone, timedelta

utc_now = datetime.now(timezone.utc)
print(utc_now)
print(utc_now.tzinfo)

Python 3.9 dodał moduł zoneinfo do nazwanych stref czasowych (korzysta z systemowej bazy IANA):

from datetime import datetime
from zoneinfo import ZoneInfo

now_tokyo = datetime.now(ZoneInfo("Asia/Tokyo"))
now_ny = datetime.now(ZoneInfo("America/New_York"))

print(now_tokyo)
print(now_ny)
print(now_tokyo - now_ny)   # timedelta bliska zeru: ta sama chwila, różne zegary

Konwertuj między strefami przez .astimezone():

from datetime import datetime
from zoneinfo import ZoneInfo

utc = datetime(2026, 4, 20, 12, 0, tzinfo=ZoneInfo("UTC"))
berlin = utc.astimezone(ZoneInfo("Europe/Berlin"))

print(utc)
print(berlin)

Zasada, którą warto zapamiętać: przechowuj daty w UTC, a na strefy lokalne zamieniaj je dopiero przy wyświetlaniu. Ten jeden nawyk zapobiega większości błędów ze strefami czasowymi.

Znaczniki czasu

Uniksowy znacznik czasu (timestamp) to liczba sekund od 1970-01-01 UTC. Python łatwo go konwertuje:

from datetime import datetime, timezone

now = datetime.now(timezone.utc)
ts = now.timestamp()

print(ts)
print(datetime.fromtimestamp(ts, tz=timezone.utc))

Znaczniki czasu przydają się do porównań, sortowania i wymiany danych z innymi systemami. Do wyjścia dla ludzi najpierw zamień je z powrotem na datetime.

Mierzenie, ile coś trwa

Do szybkich pomiarów odejmij dwa obiekty datetime:

from datetime import datetime
import time

start = datetime.now()
time.sleep(0.2)
elapsed = datetime.now() - start

print(elapsed.total_seconds())

Do poważniejszych pomiarów wydajności użyj time.perf_counter(): ma rozdzielczość poniżej mikrosekundy i jest odporne na zmiany zegara systemowego. datetime.now() wystarczy do liczb w stylu "ile trwało to wywołanie API".

Wzorce do ponownego użycia

from datetime import date, datetime, timedelta, timezone

# Dzisiejsza data w formacie ISO
print(date.today().isoformat())

# Wiek w latach (w przybliżeniu, niedokładny przy latach przestępnych)
dob = date(1990, 7, 15)
days_old = (date.today() - dob).days
print(days_old // 365, "years old")

# Początek bieżącej godziny w UTC
now = datetime.now(timezone.utc)
start_of_hour = now.replace(minute=0, second=0, microsecond=0)
print(start_of_hour)

# Siedem dni temu
print(date.today() - timedelta(days=7))

Co zapamiętać

• date, datetime i timedelta pokrywają 90% potrzeb.
• ISO-8601 dla maszyn, strftime dla ludzi.
• Przechowuj w UTC, konwertuj przy wyświetlaniu.
• Do nazwanych stref czasowych używaj zoneinfo.
• Do miesięcy i lat sięgaj po dateutil.relativedelta.

Jeszcze jedno narzędzie do praktycznego zestawu: wyrażenia regularne, zaraz dalej.