pandas.Timestamp.tz_localize#

Timestamp.tz_localize(tz, неоднозначный='raise', несуществующий='raise')#

Локализует метку времени в часовом поясе.

Преобразовать наивную метку времени в местный часовой пояс или удалить часовой пояс из метки времени с часовым поясом.

Параметры:
tzstr, pytz.timezone, dateutil.tz.tzfile или None

Часовой пояс для времени, в которое будет преобразован Timestamp. None удалит часовой пояс, сохраняя локальное время.

неоднозначныйbool, 'NaT', по умолчанию 'raise'

Когда часы переводятся назад из-за летнего времени, могут возникать неоднозначные времена. Например, в Центральноевропейском времени (UTC+01), при переходе с 03:00 летнего времени на 02:00 стандартного времени, локальное время 02:30:00 встречается как в 00:30:00 UTC, так и в 01:30:00 UTC. В такой ситуации неоднозначный параметр определяет, как следует обрабатывать неоднозначные времена.

Поведение следующее:

  • bool содержит флаги для определения, является ли время летним (DST) или нет (примечание: этот флаг применим только для неоднозначных осенних дат DST).

  • 'NaT' вернёт NaT для неоднозначного времени.

  • 'raise' вызовет AmbiguousTimeError для неоднозначного времени.

несуществующий‘shift_forward’, ‘shift_backward, ‘NaT’, timedelta, по умолчанию ‘raise’

Несуществующее время не существует в определенном часовом поясе, где часы перевели вперед из-за летнего времени.

Поведение следующее:

  • 'shift_forward' сдвинет несуществующее время вперед до ближайшего существующего времени.

  • 'shift_backward' сдвинет несуществующее время назад к ближайшему существующему времени.

  • ‘NaT’ вернет NaT там, где есть несуществующие времена.

  • объекты timedelta будут сдвигать несуществующие времена на timedelta.

  • 'raise' вызовет ошибку NonExistentTimeError, если есть несуществующие времена.

Возвращает:
локализованныйTimestamp
Вызывает:
TypeError

Если Timestamp учитывает часовой пояс и tz не равен None.

Примеры

Создать наивный объект временной метки:

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

Добавить 'Europe/Stockholm' как часовой пояс:

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