pandas.Series.tz_convert

Series.tz_convert(tz, axis=0, level=None, copy=None)

将时区感知的轴转换为目标时区。

Parameters:

tz字符串或 tzinfo 对象或 None

目标时区。 传递 None 将转换为 UTC 并删除时区信息。

axis{0 或 ‘index’, 1 或 ‘columns’}, default 0

要转换的轴

level整数、字符串、默认 None

如果 axis 是 MultiIndex，则转换特定级别。 否则必须是 None。

copybool, default True

同时复制底层数据。

备注

copy 关键字在 pandas 3.0 中将更改行为。Copy-on-Write 将默认启用，这意味着所有带有 copy 关键字的方法都将使用惰性复制机制来延迟复制并忽略 copy 关键字。copy 关键字将在 pandas 的未来版本中移除。

通过启用 copy on write pd.options.mode.copy_on_write = True，您可以获得未来的行为和改进。

Returns:

Series/DataFrame

时区已转换轴的对象。

Raises:

TypeError

如果轴是 tz-naive（无时区信息）。

Examples

转换为另一个时区：

>>> s = pd.Series(
...     [1],
...     index=pd.DatetimeIndex(['2018-09-15 01:30:00+02:00']),
... )
>>> s.tz_convert('Asia/Shanghai')
2018-09-15 07:30:00+08:00    1
dtype: int64

传递 None 以转换为 UTC 并获取 tz-naive 索引：

>>> s = pd.Series([1],
...               index=pd.DatetimeIndex(['2018-09-15 01:30:00+02:00']))
>>> s.tz_convert(None)
2018-09-14 23:30:00    1
dtype: int64