pandas.Timestamp.astimezone

Timestamp.astimezone(tz)

将时区感知的 Timestamp 转换为另一个时区。

此方法用于将一个带时区的 Timestamp 对象转换到不同的时区。原始的 UTC 时间保持不变；只有时区信息被更改。如果 Timestamp 是无时区的，则会引发 TypeError。

参数:

tzstr, zoneinfo.ZoneInfo, pytz.timezone, dateutil.tz.tzfile 或 None

时间戳将被转换到的时间区域。None 将移除时区，保持 UTC 时间。

返回:

已转换时间戳

引发:

TypeError

如果时间戳是时区未知的。

参见

Timestamp.tz_localize

将时间戳本地化为一个时区。

DatetimeIndex.tz_convert

将 DatetimeIndex 转换为另一个时区。

DatetimeIndex.tz_localize

将 DatetimeIndex 本地化为特定时区。

datetime.datetime.astimezone

将一个 datetime 对象转换为另一个时区。

示例

使用UTC时区创建一个时间戳对象：

>>> ts = pd.Timestamp('2020-03-14T15:32:52.192548651', tz='UTC')
>>> ts
Timestamp('2020-03-14 15:32:52.192548651+0000', tz='UTC')

切换到东京时区：

>>> ts.tz_convert(tz='Asia/Tokyo')
Timestamp('2020-03-15 00:32:52.192548651+0900', tz='Asia/Tokyo')

也可以使用 astimezone：

>>> ts.astimezone(tz='Asia/Tokyo')
Timestamp('2020-03-15 00:32:52.192548651+0900', tz='Asia/Tokyo')

类似于 pd.NaT：

>>> pd.NaT.tz_convert(tz='Asia/Tokyo')
NaT