Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Python

datetime.tzinfo

Sert de classe de base pour définir des règles de fuseau.

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

Syntaxe

class Fixed(datetime.tzinfo): ...

Sert de classe de base pour définir des règles de fuseau.

fromutc reçoit des champs exprimés en UTC avec dt.tzinfo is self. Elle renvoie la date et l’heure locales correspondantes dans ce fuseau. utcoffset(dt) fournit le décalage total incluant l’heure d’été, strictement entre -24 h et +24 h, ou None si inconnu. dst(dt) donne la part saisonnière et tzname(dt) le nom. Des règles de conversion peuvent exiger fromutc.

Dans l’exemple 07:00 porte le décalage +03:00 et une correction saisonnière nulle.

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)

Exemples

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())

Résultat

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

Dans l’exemple 07:00 porte le décalage +03:00 et une correction saisonnière nulle.

Sources