polars.Series.dt.base_utc_offset#

Series.dt.base_utc_offset() → Series[source]#

与UTC的基本偏移量。

对于给定时区中的所有日期时间，这通常是恒定的，但在极少数情况下可能会有所不同，例如萨摩亚（阿皮亚）在2011年底切换时区时。

Returns:

Series: 数据类型为 Duration 的系列。

另请参阅

Series.dt.dst_offset: 当前生效的额外偏移量。

示例

>>> from datetime import datetime
>>> s = pl.datetime_range(
...     datetime(2011, 12, 29),
...     datetime(2012, 1, 1),
...     "2d",
...     time_zone="Pacific/Apia",
...     eager=True,
... ).alias("datetime")
>>> s
shape: (2,)
Series: 'datetime' [datetime[μs, Pacific/Apia]]
[
        2011-12-29 00:00:00 -10
        2011-12-31 00:00:00 +14
]
>>> s.dt.base_utc_offset()
shape: (2,)
Series: 'datetime' [duration[ms]]
[
        -11h
        13h
]