Атрибут tz

Атрибут tz применяется к объекту DatetimeIndex и возвращает информацию о часовом поясе. Если временной индекс не имеет привязанного часового пояса, атрибут возвращает None. Часовой пояс хранится в виде объекта tzinfo из библиотеки pytz или zoneinfo.

Атрибут используется только для чтения. Для установки часового пояса применяется метод tz_localize, а для преобразования между часовыми поясами - метод tz_convert.

Синтаксис

datetime_index.tz

Пример

Давайте создадим временной индекс без часового пояса и проверим значение атрибута:

import pandas as pd

idx = pd.DatetimeIndex(['2026-01-01', '2026-01-02', '2026-01-03'])
print(idx.tz)

Результат выполнения кода:

None

Пример

Теперь создадим индекс с привязанным часовым поясом и выведем его атрибут:

import pandas as pd

idx = pd.DatetimeIndex(
	['2026-01-01', '2026-01-02', '2026-01-03'],
	tz='Europe/Moscow'
)
print(idx.tz)

Результат выполнения кода:

"Europe/Moscow"

Пример

Проверим атрибут tz после использования метода tz_localize для установки часового пояса:

import pandas as pd

idx = pd.DatetimeIndex(['2026-01-01', '2026-01-02', '2026-01-03'])
idx_localized = idx.tz_localize('UTC')
print(idx_localized.tz)

Результат выполнения кода:

"UTC"

Пример

Рассмотрим работу атрибута с индексом в DataFrame:

import pandas as pd

idx = pd.DatetimeIndex(
	['2026-01-01', '2026-01-02', '2026-01-03'],
	tz='America/New_York'
)
df = pd.DataFrame({'a': [1, 2, 3], 'b': [10, 20, 30]}, index=idx)
print(df.index.tz)

Результат выполнения кода:

"America/New_York"

Смотрите также

атрибут freq,
который возвращает частоту временного индекса
метод tz_localize,
который устанавливает часовой пояс
метод tz_convert,
который преобразует часовой пояс
класс DatetimeIndex,
который представляет временной индекс