pandas.Series.tz_localize

Series.tz_localize(tz, axis=0, level=None, copy=True, ambiguous='raise', nonexistent='raise')[source]

Локализация индекса Series или DataFrame, не имеющего часового пояса, в целевой часовой пояс.

Данная операция локализует индекс. Для локализации значений в Series без часового пояса используйте Series.dt.tz_localize().

Параметры

tz:строка или tzinfo

axis:ось для локализации

level:int, строка, по умолчанию None

Если ось является MultiIndex, локализовать определённый уровень. В противном случае должно быть None.

copy:bool, по умолчанию True

Также создать копию исходных данных.

ambiguous:'infer', bool-массив, 'NaT', по умолчанию 'raise'

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

• ‘infer’ попытается определить часы перехода на зимнее время по порядку

• bool-массив, где True означает время DST, а False — время вне DST (обратите внимание, что этот флаг применим только к неоднозначным моментам)

• ‘NaT’ вернёт NaT в случае неоднозначных моментов

• ‘raise’ сгенерирует AmbiguousTimeError, если существуют неоднозначные моменты.

nonexistent:строка, по умолчанию 'raise'

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

• ‘shift_forward’ переместит несуществующее время вперёд к ближайшему существующему времени

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

• ‘NaT’ вернёт NaT в случае несуществующих моментов

• объекты timedelta сместят несуществующие моменты на указанное количество времени

• ‘raise’ сгенерирует NonExistentTimeError, если существуют несуществующие моменты.

Возвращаемое значение

Series/DataFrame

Тип тот же, что и у входных данных.

Исключения

TypeError

Если TimeSeries имеет часовой пояс и tz не None.

Примеры

Локализация местного времени:

>>> s = pd.Series([1],
...               index=pd.DatetimeIndex(['2018-09-15 01:30:00']))
>>> s.tz_localize('CET')
2018-09-15 01:30:00+02:00    1
dtype: int64

Будьте внимательны с переходами на летнее время. При последовательных данных pandas может определить время перехода на летнее время:

>>> s = pd.Series(range(7),
...               index=pd.DatetimeIndex(['2018-10-28 01:30:00',
...                                       '2018-10-28 02:00:00',
...                                       '2018-10-28 02:30:00',
...                                       '2018-10-28 02:00:00',
...                                       '2018-10-28 02:30:00',
...                                       '2018-10-28 03:00:00',
...                                       '2018-10-28 03:30:00']))
>>> s.tz_localize('CET', ambiguous='infer')
2018-10-28 01:30:00+02:00    0
2018-10-28 02:00:00+02:00    1
2018-10-28 02:30:00+02:00    2
2018-10-28 02:00:00+01:00    3
2018-10-28 02:30:00+01:00    4
2018-10-28 03:00:00+01:00    5
2018-10-28 03:30:00+01:00    6
dtype: int64

В некоторых случаях определить переход на летнее время невозможно. В таких случаях можно передать массив ndarray в параметр ambiguous, чтобы явно задать время DST

>>> s = pd.Series(range(3),
...               index=pd.DatetimeIndex(['2018-10-28 01:20:00',
...                                       '2018-10-28 02:36:00',
...                                       '2018-10-28 03:46:00']))
>>> s.tz_localize('CET', ambiguous=np.array([True, True, False]))
2018-10-28 01:20:00+02:00    0
2018-10-28 02:36:00+02:00    1
2018-10-28 03:46:00+01:00    2
dtype: int64

Если переход на летнее время приводит к несуществующим моментам, можно сдвинуть эти даты вперёд или назад с помощью объекта timedelta или ‘shift_forward’ или ‘shift_backward’.

>>> s = pd.Series(range(2),
...               index=pd.DatetimeIndex(['2015-03-29 02:30:00',
...                                       '2015-03-29 03:30:00']))
>>> s.tz_localize('Europe/Warsaw', nonexistent='shift_forward')
2015-03-29 03:00:00+02:00    0
2015-03-29 03:30:00+02:00    1
dtype: int64
>>> s.tz_localize('Europe/Warsaw', nonexistent='shift_backward')
2015-03-29 01:59:59.999999999+01:00    0
2015-03-29 03:30:00+02:00              1
dtype: int64
>>> s.tz_localize('Europe/Warsaw', nonexistent=pd.Timedelta('1H'))
2015-03-29 03:30:00+02:00    0
2015-03-29 03:30:00+02:00    1
dtype: int64