pandas.Timestamp.tz_localize#

Timestamp.tz_localize(tz, ambiguous='raise', nonexistent='raise')#

将原始时间戳转换为本地时区,或从支持时区的时间戳中删除时区。

参数
tzStr、pytz.timezone、Dateutil.tz.tz文件或无

时间戳将转换为的时间的时区。都不会删除保留本地时间的时区。

ambiguousBool,‘NAT’,默认‘RAISE’

当时钟因DST向后移动时,可能会出现时间不明确的情况。例如,在中欧时间(UTC+01),当从DST 03:00到非DST 02:00时,当地时间02:30:00同时出现在UTC 00:30:00和01:30:00 UTC。在这种情况下, ambiguous 参数指示应如何处理不明确的时间。

其行为如下:

  • Bool包含用于确定时间是否为DST的标志(请注意,此标志仅适用于不明确的秋季DST日期)。

  • “NaT”将在不明确的时间返回NAT。

  • “Raise”将在不明确的时间引发AmbiguousTimeError。

nonexistent‘Shift_Forward’,‘Shift_Backward,’NAT‘,TimeDelta,默认’RAISE‘

在时钟由于DST而向前移动的特定时区中不存在不存在的时间。

其行为如下:

  • ‘Shift_Forward’会将不存在的时间向前移动到最接近的现有时间。

  • ‘Shift_Backup’会将不存在的时间向后移动到最接近的现有时间。

  • “NaT”将返回不存在时间的NAT。

  • 时间增量对象将按时间增量移动不存在的时间。

  • 如果存在不存在的时间,“Raise”将引发非ExistentTimeError。

退货
localized时间戳
加薪
TypeError

如果时间戳是TZ感知的,并且TZ不是None。

示例

创建一个朴素的时间戳对象:

>>> ts = pd.Timestamp('2020-03-14T15:32:52.192548651')
>>> ts
Timestamp('2020-03-14 15:32:52.192548651')

添加“欧洲/斯德哥尔摩”作为时区:

>>> ts.tz_localize(tz='Europe/Stockholm')
Timestamp('2020-03-14 15:32:52.192548651+0100', tz='Europe/Stockholm')

类似于 pd.NaT

>>> pd.NaT.tz_localize()
NaT