KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

datetime.time

Beschrijft een kloktijd onafhankelijk van een bepaalde datum.

Versie: Python 3.14; repository image, production runtime not attested

Syntax

datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

Beschrijft een kloktijd onafhankelijk van een bepaalde datum.

Zonder datum roept time utcoffset(None) aan. Een seizoenszone kan dan None geven, dus tzinfo alleen garandeert geen bekend verschil. Uren zijn 0–23, minuten en seconden 0–59 en microseconden 0–999999. Weggelaten klokvelden krijgen nul. Zowel 24:00 als een schrikkelseconde valt buiten het bereik.

Het voorbeeld toont 08:05:00 en uur 24 geeft 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

Voorbeelden

import datetime
print(datetime.time(8, 5).isoformat())
try:
    datetime.time(24, 0)
except ValueError as error:
    print(type(error).__name__)

Resultaat

08:05:00
ValueError

Het voorbeeld toont 08:05:00 en uur 24 geeft ValueError.

Bronnen