CKTIS / Python
datetime.time
Opisuje godzinę niezależnie od konkretnej daty.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)Opisuje godzinę niezależnie od konkretnej daty.
Obiekt time nie przekazuje daty, tylko wywołuje utcoffset(None). Strefa z regułami sezonowymi może wtedy zwrócić None, więc sama obecność tzinfo nie zapewnia znanego przesunięcia. Godzina ma zakres 0–23, minuty i sekundy 0–59, a mikrosekundy 0–999999. Pominięte pola zegara mają wartość zero. Konstruktor nie przyjmuje 24:00 ani sekundy przestępnej.
W przykładzie wyświetla się 08:05:00, a godzina 24 zgłasza 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
Przykłady
import datetime
print(datetime.time(8, 5).isoformat())
try:
datetime.time(24, 0)
except ValueError as error:
print(type(error).__name__)
Wynik
08:05:00 ValueError
W przykładzie wyświetla się 08:05:00, a godzina 24 zgłasza ValueError.