Spec-Zone.ru › pandas 0.25

pandas.Timestamp.tz_localize

Timestamp.tz_localize(self, tz, ambiguous='raise', nonexistent='raise', errors=None)

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

Параметры:
tz : str, pytz.timezone, dateutil.tz.tzfile or None

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

ambiguous : bool, ‘NaT’, default ‘raise’

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

  • bool содержит флаги для определения, является ли время летним или нет (обратите внимание, что этот флаг применим только к неоднозначным датам осени летнего времени)
  • ‘NaT’ вернёт NaT для неоднозначного времени
  • ‘raise’ вызовет AmbiguousTimeError для неоднозначного времени
nonexistent : ‘shift_forward’, ‘shift_backward, ‘NaT’, timedelta, default ‘raise’

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

  • ‘shift_forward’ сместит несуществующее время вперёд до ближайшего существующего времени
  • ‘shift_backward’ сместит несуществующее время назад до ближайшего существующего времени
  • ‘NaT’ вернёт NaT в случае несуществующего времени
  • объекты timedelta сместят несуществующее время на указанное смещение
  • ‘raise’ вызовет NonExistentTimeError, если существуют несуществующие моменты времени

Новое в версии 0.24.0.

errors : ‘raise’, ‘coerce’, default None
  • ‘raise’ вызовет NonExistentTimeError, если временная отметка не

    действительна в указанном часовом поясе (например, из-за перехода в или из летнего времени). Используйте nonexistent='raise' вместо этого.

  • ‘coerce’ вернёт NaT, если временную отметку нельзя преобразовать в указанный часовой пояс. Используйте nonexistent='NaT' вместо этого.

    Устарело начиная с версии 0.24.0.

Возвращает:
localized : Timestamp
Возбуждает:
TypeError

Если временная отметка с часовым поясом и tz не равно None.

© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.25.0/reference/api/pandas.Timestamp.tz_localize.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API