pandas.DatetimeIndex.tz_localize

DatetimeIndex.tz_localize(tz, ambiguous='raise', errors='raise') [source]

Локализация часового пояса для DatetimeIndex без часового пояса.

Этот метод принимает объект DatetimeIndex без часового пояса и делает его часовым. Он не перемещает время в другой часовой пояс. Локализация часового пояса помогает переключаться между объектами с часовым поясом и без него.

Параметры:	tz : строка, pytz.timezone, dateutil.tz.tzfile или None Часовой пояс для преобразования временных меток. Передача None удалит информацию о часовом поясе, сохранив местное время. ambiguous : str {‘infer’, ‘NaT’, ‘raise’} или массив bool, по умолчанию ‘raise’ ‘infer’ попытается определить часы перехода на летнее время осенью, основываясь на порядке массив bool-ndarray, где True обозначает время летнего времени, False — время вне летнего времени (обратите внимание, что этот флаг применим только для неоднозначных времен) ‘NaT’ вернёт NaT, если есть неоднозначные времена ‘raise’ поднимет исключение AmbiguousTimeError, если есть неоднозначные времена errors : {‘raise’, ‘coerce’}, по умолчанию ‘raise’ ‘raise’ поднимет исключение NonExistentTimeError, если временная метка не является допустимой в указанном часовом поясе (например, из-за перехода к или от летнего времени) ‘coerce’ вернёт NaT, если временную метку нельзя преобразовать в указанный часовой пояс Добавлен в версии 0.19.0.
Возвращает:	DatetimeIndex Индекс, преобразованный в указанный часовой пояс.
Возможные исключения:	TypeError Если DatetimeIndex с часовым поясом, а tz не равно None.

См. также

DatetimeIndex.tz_convert

Преобразовать DatetimeIndex с часовым поясом из одного часового пояса в другой.

Примеры

>>> tz_naive = pd.date_range('2018-03-01 09:00', periods=3)
>>> tz_naive
DatetimeIndex(['2018-03-01 09:00:00', '2018-03-02 09:00:00',
               '2018-03-03 09:00:00'],
              dtype='datetime64[ns]', freq='D')

Локализация DatetimeIndex в часовом поясе US/Eastern:

>>> tz_aware = tz_naive.tz_localize(tz='US/Eastern')
>>> tz_aware
DatetimeIndex(['2018-03-01 09:00:00-05:00',
               '2018-03-02 09:00:00-05:00',
               '2018-03-03 09:00:00-05:00'],
              dtype='datetime64[ns, US/Eastern]', freq='D')

С помощью tz=None, мы можем удалить информацию о часовом поясе, сохранив местное время (не преобразуя его в UTC):

>>> tz_aware.tz_localize(None)
DatetimeIndex(['2018-03-01 09:00:00', '2018-03-02 09:00:00',
               '2018-03-03 09:00:00'],
              dtype='datetime64[ns]', freq='D')