Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes