Spec-Zone.ru › pandas 0.24

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

Spec-Zone.ru

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