pandas.DataFrame.tz_convert

DataFrame.tz_convert(tz, axis=0, level=None, copy=None)[source]

Преобразование оси, осознающей часовой пояс, в целевой часовой пояс.

Параметры:

tz:строка или объект tzinfo или None

Целевой часовой пояс. Передача None приведет к преобразованию в UTC и удалению информации о часовом поясе.

axis:{0 или ‘index’, 1 или ‘columns’}, по умолчанию 0

Ось для преобразования

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

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

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

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

Примечание

Ключевое слово copy изменит поведение в pandas 3.0. Копирование по мере необходимости будет включено по умолчанию, что означает, что все методы с ключевым словом copy будут использовать механизм ленивого копирования для отсрочки копирования и игнорирования ключевого слова copy. Ключевое слово copy будет удалено в будущих версиях pandas.

Вы уже можете получить будущее поведение и улучшения, включив копирование по мере необходимости pd.options.mode.copy_on_write = True

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

Series/DataFrame

Объект с преобразованной осью часового пояса.

Исключения:

TypeError

Если ось не осознаёт часовой пояс.

Примеры

Изменение на другой часовой пояс:

>>> s = pd.Series(
...     [1],
...     index=pd.DatetimeIndex(['2018-09-15 01:30:00+02:00']),
... )
>>> s.tz_convert('Asia/Shanghai')
2018-09-15 07:30:00+08:00    1
dtype: int64

Передача None для преобразования в UTC и получения индекса без часового пояса:

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