akkudoktoreos.utils.datetimeutil.to_duration

akkudoktoreos.utils.datetimeutil.to_duration(input_value: Duration | timedelta | str | int | float | Tuple[int, int, int, int] | List[int]) → Duration

Converts various input types into a Duration object using pendulum.

Parameters:

input_value (Union[Duration, timedelta, str, int, float, tuple, list]) – Input to be converted into a timedelta: - str: A duration string like “2 days”, “5 hours”, “30 minutes”, or a combination. - int/float: Number representing seconds. - tuple/list: A tuple or list in the format (days, hours, minutes, seconds).

Returns:

A Duration object corresponding to the input value.

Return type:

duration

Raises:

ValueError – If the input format is not supported.

Examples

>>> to_duration("2 days 5 hours")
timedelta(days=2, seconds=18000)

>>> to_duration(3600)
timedelta(seconds=3600)

>>> to_duration((1, 2, 30, 15))
timedelta(days=1, seconds=90315)