Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

datetime.tzinfo

Stanowi klasę bazową dla własnych reguł stref czasowych.

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

Składnia

class Fixed(datetime.tzinfo): ...

Stanowi klasę bazową dla własnych reguł stref czasowych.

fromutc otrzymuje pola wyrażone w UTC, przy czym dt.tzinfo is self. Zwraca odpowiadającą im lokalną datę i godzinę w tej strefie. utcoffset(dt) daje całkowite przesunięcie z czasem letnim, ściśle w granicach ±24 h, lub None, gdy nieznane. dst(dt) opisuje część sezonową, a tzname(dt) nazwę. Własne reguły konwersji mogą wymagać fromutc.

W przykładzie 07:00 ma przesunięcie +03:00 i sezonową poprawkę równą zero.

from datetime import datetime, timedelta, tzinfo
class Office(tzinfo):
    def utcoffset(self, dt): return timedelta(hours=3)
    def dst(self, dt): return timedelta(0)
    def tzname(self, dt): return "OFF"
t = datetime(2025, 1, 2, 7, tzinfo=Office())
assert (t.utcoffset(), t.dst(), t.tzname()) == (timedelta(hours=3), timedelta(0), "OFF")
z = t.tzinfo
fields = datetime(2025, 1, 2, 7, tzinfo=z)
assert z.fromutc(fields) == datetime(2025, 1, 2, 10, tzinfo=z)

Przykłady

import datetime
class Fixed(datetime.tzinfo):
    def utcoffset(self, dt): return datetime.timedelta(hours=3)
    def dst(self, dt): return datetime.timedelta(0)

t = datetime.datetime(2025, 1, 2, 7, tzinfo=Fixed())
print(t.isoformat())
print(t.dst())

Wynik

2025-01-02T07:00:00+03:00
0:00:00

W przykładzie 07:00 ma przesunięcie +03:00 i sezonową poprawkę równą zero.

Źródła