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.