Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes