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