CKTIS / Python
datetime.tzinfo
Serve de classe base para regras de fuso horário.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
class Fixed(datetime.tzinfo): ...Serve de classe base para regras de fuso horário.
fromutc recebe campos expressos em UTC com dt.tzinfo is self. Devolve a data e a hora locais correspondentes neste fuso. utcoffset(dt) fornece o desvio total incluindo a hora de verão, estritamente entre -24 h e +24 h, ou None se desconhecido. dst(dt) indica a parte sazonal e tzname(dt) o nome. Algumas regras de conversão requerem fromutc.
No exemplo 07:00 tem desvio +03:00 e correção sazonal 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)
Exemplos
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())
Resultado
2025-01-02T07:00:00+03:00 0:00:00
No exemplo 07:00 tem desvio +03:00 e correção sazonal zero.