pandas.Series.tz_localize

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

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

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

Параметры:	tz : string or pytz.timezone object axis : the axis to localize level : int, str, default None Если ось является MultiIndex, локализуется определённый уровень. В противном случае должно быть None copy : boolean, default True Также создаёт копию базовых данных ambiguous : ‘infer’, bool-ndarray, ‘NaT’, default ‘raise’ Когда часы переводятся назад из-за летнего времени, могут возникнуть неоднозначные моменты времени. Например, в Центральноевропейском времени (UTC+01), при переходе от 03:00 DST к 02:00 non-DST, 02:30:00 местного времени соответствует 00:30:00 UTC и 01:30:00 UTC. В такой ситуации параметр ambiguous определяет, как следует обрабатывать неоднозначные моменты времени. ‘infer’ — попытается определить часы перехода на летнее время в зависимости от порядка булев массив, где True обозначает время летнего времени, False — время вне летнего времени (обратите внимание, что этот флаг применим только к неоднозначным моментам времени) ‘NaT’ — возвращает NaT, когда есть неоднозначные моменты времени ‘raise’ — вызовет AmbiguousTimeError, если есть неоднозначные моменты времени nonexistent : str, default ‘raise’ Несуществующее время не существует в определённой временной зоне, когда часы переведены вперёд из-за летнего времени. Допустимые значения: ‘shift_forward’ — переместит несуществующее время вперёд к ближайшему существующему времени ‘shift_backward’ — переместит несуществующее время назад к ближайшему существующему времени ‘NaT’ — вернёт NaT, когда есть несуществующие моменты времени объекты timedelta — сдвинут несуществующие моменты времени на timedelta ‘raise’ — вызовет NonExistentTimeError, если есть несуществующие моменты времени Введено в версии 0.24.0.
Возвращает:	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, чтобы явно указать время летнего времени

>>> 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_backwards’. >>> 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