Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła