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

CKTIS / Python

datetime.time

Représente une heure indépendamment de la date.

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

Syntaxe

datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

Représente une heure indépendamment de la date.

Sans date, time appelle utcoffset(None). Un fuseau saisonnier peut alors renvoyer None, donc la seule présence de tzinfo ne garantit pas un décalage connu. Les heures vont de 0 à 23, minutes et secondes de 0 à 59 et microsecondes de 0 à 999999. Les champs horaires omis valent zéro. Ni 24:00 ni une seconde intercalaire ne sont admis.

L’exemple affiche 08:05:00 et l’heure 24 lève ValueError.

from datetime import time
assert time().isoformat() == "00:00:00"
assert time(23, 59, 59, 999999) == time.max
for args in [(24,), (1, 60), (1, 2, 60)]:
    try:
        time(*args)
    except ValueError:
        pass
    else:
        raise AssertionError
from datetime import tzinfo
class Seasonal(tzinfo):
    def utcoffset(self, dt):
        assert dt is None
        return None
assert time(8, tzinfo=Seasonal()).utcoffset() is None

Exemples

import datetime
print(datetime.time(8, 5).isoformat())
try:
    datetime.time(24, 0)
except ValueError as error:
    print(type(error).__name__)

Résultat

08:05:00
ValueError

L’exemple affiche 08:05:00 et l’heure 24 lève ValueError.

Sources