pandas.Timestamp.tz_localize
-
Timestamp.tz_localize -
Преобразование неявного объекта Timestamp в локальную временную зону или удаление временной зоны из объекта Timestamp, осознающего временную зону.
Параметры: -
tz : str, pytz.timezone, dateutil.tz.tzfile or None -
Временная зона, к которой будет преобразован объект Timestamp. Значение None удалит временную зону, сохранив локальное время.
-
ambiguous : bool, ‘NaT’, default ‘raise’ -
Когда часы переводятся назад из-за DST, могут возникнуть неоднозначные моменты времени. Например, в Центральноевропейском времени (UTC+01), при переходе с 03:00 DST на 02:00 non-DST, 02:30:00 локального времени соответствует 00:30:00 UTC и 01:30:00 UTC. В такой ситуации параметр
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, если существуют несуществующие моменты времени.
Добавлена в версии 0.24.0.
-
errors : ‘raise’, ‘coerce’, default None -
-
- ‘raise’ вызовет NonExistentTimeError, если метка времени не является
-
действительной в указанной временной зоне (например, из-за перехода на летнее или зимнее время). Используйте
nonexistent='raise'вместо этого.
-
‘coerce’ вернёт NaT, если метка времени не может быть преобразована в указанную временную зону. Используйте
nonexistent='NaT'вместо этого.Устарело начиная с версии 0.24.0.
-
Возвращает: -
localized : Timestamp
Возбуждает: - TypeError
-
Если объект Timestamp осознает временную зону и 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.24.2/reference/api/pandas.Timestamp.tz_localize.html