CKTIS / Python
datetime.time
Representa una hora con independencia de una fecha concreta.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)Representa una hora con independencia de una fecha concreta.
Al carecer de fecha, time llama a utcoffset(None). Una zona estacional puede devolver None, por lo que la mera presencia de tzinfo no garantiza un desplazamiento conocido. Las horas van de 0 a 23, los minutos y segundos de 0 a 59 y los microsegundos de 0 a 999999. Los campos horarios omitidos valen cero. No admite 24:00 ni un segundo intercalar.
El ejemplo muestra 08:05:00 y la hora 24 produce 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
Ejemplos
import datetime
print(datetime.time(8, 5).isoformat())
try:
datetime.time(24, 0)
except ValueError as error:
print(type(error).__name__)
Resultado
08:05:00 ValueError
El ejemplo muestra 08:05:00 y la hora 24 produce ValueError.