Python pandas.Timestamp.tz_localize用法及代碼示例

用法: Timestamp.tz_localize(tz, ambiguous='raise', nonexistent='raise')

將原始時間戳轉換為本地時區，或從 timezone-aware 時間戳中刪除時區。

參數：

tz：str、pytz.timezone、dateutil.tz.tzfile 或無

Timestamp 將轉換到的時間的時區。 None 將刪除保存本地時間的時區。

ambiguous：bool, ‘NaT’, 默認 ‘raise’

當時鍾由於 DST 向後移動時，可能會出現不明確的時間。例如，在歐洲中部時間 (UTC+01) 中，當從 03:00 DST 到 02:00 非 DST 時，當地時間 02:30:00 發生在 00:30:00 UTC 和 01:30:00世界標準時間。在這種情況下，ambiguous 參數指示應如何處理模棱兩可的時間。

行為如下：

bool 包含用於確定時間是否為 dst 的標誌(請注意，此標誌僅適用於不明確的秋季 dst 日期)。
'NaT' 將返回 NaT 一段不明確的時間。
‘raise’ 將在不明確的時間內引發 AmbiguousTimeError。

nonexistent：‘shift_forward’, ‘shift_backward, ‘NaT’, timedelta, 默認 ‘raise’

由於 DST，時鍾向前移動的特定時區不存在不存在的時間。

行為如下：

‘shift_forward’ 會將不存在的時間向前移動到最接近的現有時間。
‘shift_backward’ 會將不存在的時間向後移動到最接近的現有時間。
‘NaT’ 將在不存在時間的地方返回 NaT。
timedelta 對象將按 timedelta 移動不存在的時間。
如果時間不存在，‘raise’ 將引發 NonExistentTimeError。

localized：時間戳

拋出：

TypeError: 如果時間戳為 tz-aware 且 tz 不是無。

例子：

創建一個簡單的時間戳對象：

>>> 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

相關用法

注：本文由純淨天空篩選整理自pandas.pydata.org大神的英文原創作品 pandas.Timestamp.tz_localize。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。

用法:

參數：

返回：

拋出：

例子：