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