Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

datetime.datetime

Łączy datę z godziną z dokładnością do mikrosekundy.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

Łączy datę z godziną z dokładnością do mikrosekundy.

Podczas cofnięcia zegara w Nowym Jorku 2024-11-03 godzina 01:30 oznacza 05:30 UTC dla fold=0 i 06:30 UTC dla fold=1. Odejmowanie przy identycznym obiekcie tzinfo ignoruje fold i daje zero, a po konwersji do UTC różnica wynosi godzinę. Obiekt jest świadomy strefy, gdy tzinfo zwraca przesunięcie względem UTC różne od None. astimezone zachowuje chwilę, a replace(tzinfo=...) zmienia oznaczenie przy tych samych polach.

1 stycznia o 01:00 UTC to 31 grudnia o 22:00 przy przesunięciu -03:00.

from datetime import datetime, timedelta, timezone
stamp = datetime(2025, 1, 1, 1, tzinfo=timezone.utc)
zone = timezone(timedelta(hours=-3))
local = stamp.astimezone(zone)
assert local.isoformat() == "2024-12-31T22:00:00-03:00" and local == stamp
assert stamp.replace(tzinfo=zone) != stamp
from datetime import tzinfo
class RepeatedHour(tzinfo):
    def utcoffset(self, dt): return timedelta(hours=-4-dt.fold)
    def dst(self, dt): return timedelta(hours=1-dt.fold)
z = RepeatedHour()
a = datetime(2024,11,3,1,30,tzinfo=z)
b = a.replace(fold=1)
assert b-a == timedelta(0)
assert (a.astimezone(timezone.utc).hour, b.astimezone(timezone.utc).hour) == (5,6)
assert b.astimezone(timezone.utc)-a.astimezone(timezone.utc) == timedelta(hours=1)

datetime.datetime.strptime · datetime.datetime.date · datetime.datetime.combine · datetime.datetime.replace · datetime.datetime.strftime · datetime.datetime.isoformat

strptime(text, fmt) odczytuje pola według formatu, a date() wydziela datę. combine(data, czas) łączy je i domyślnie przejmuje tzinfo czasu. replace tworzy nową wartość z podmienionymi polami bez przeliczania strefy i odrzuca niepoprawną datę. strftime(fmt) formatuje według dyrektyw, isoformat() zapisuje postać ISO z offsetem dla tej daty świadomej strefy.

from datetime import datetime,time,timezone
d=datetime.strptime('2024-02-29','%Y-%m-%d')
t=time(8,30,tzinfo=timezone.utc)
combined=datetime.combine(d.date(),t)
later=combined.replace(hour=9)
assert combined.hour==8 and later.strftime('%Y/%m/%d %H:%M')=='2024/02/29 09:30'
assert later.isoformat()=='2024-02-29T09:30:00+00:00'
try: d.replace(year=2023)
except ValueError: pass
else: raise AssertionError

Przykłady

import datetime
utc = datetime.timezone.utc
t = datetime.datetime(2025, 1, 1, 1, tzinfo=utc)
local = t.astimezone(datetime.timezone(datetime.timedelta(hours=-3)))
print(local.isoformat())
print(local == t)

Wynik

2024-12-31T22:00:00-03:00
True

1 stycznia o 01:00 UTC to 31 grudnia o 22:00 przy przesunięciu -03:00.

Źródła