pyrfc3339.utils – Utilities for working with timestamps

pyrfc3339.utils.datetime_utcoffset(dt: datetime) → float

Return the UTC offset for an aware datetime.datetime in seconds.

>>> from datetime import datetime
>>> from zoneinfo import ZoneInfo
>>> z = ZoneInfo('US/Eastern')
>>> dt = datetime(2024, 11, 5, 19, 7, 6, tzinfo=z)
>>> datetime_utcoffset(dt)
-18000.0

>>> dt = datetime(2024, 11, 5, 19, 7, 6)
>>> datetime_utcoffset(dt)
Traceback (most recent call last):
...
AssertionError

Parameters:

dt (datetime.datetime) – a datetime instance; must be aware (that is, have a timezone attached)

Returns:

the UTC offset of the supplied datetime in seconds

Return type:

float