lair.clock.TimeRange

class lair.clock.TimeRange(time_range=None, start=None, stop=None)

Bases: object

TimeRange class to represent a time range with start and stop times.

Parameters:

• time_range (TimeRange | str | list[str | datetime | None] | tuple[str | datetime | None, str | datetime | None] | slice | None)

• start (str | list[str | datetime | None] | tuple[str | datetime | None, str | datetime | None] | slice | None | datetime)

• stop (str | list[str | datetime | None] | tuple[str | datetime | None, str | datetime | None] | slice | None | datetime)

start

The start time of the time range.

Type:

dt.datetime | None

stop

The stop time of the time range.

Type:

dt.datetime | None

total_seconds

The total number of seconds in the time range.

Type:

float

parse_iso(string: str, inclusive: bool = False) → dt.datetime

Parse the ISO8601 formatted time string and return a datetime object.

Parameters:

• string (str)

• inclusive (bool)

Return type:

datetime

static parse_iso(string, inclusive=False)

Parse the ISO8601 formatted time string and return a namedtuple with the parsed components.

Parameters:

• string (str) – The ISO8601 formatted time string.

• inclusive (bool)

Returns:

dt.datetime – The parsed datetime object.

Raises:

ValueError – If the time_str format is invalid.

Return type:

datetime