Атрибут tz
Атрибут tz аксессора dt применяется к Series
с datetime-значениями и возвращает информацию о часовом поясе.
Если временная метка не имеет часового пояса (наивная),
возвращается None. Для объектов с указанным часовым поясом
возвращается объект tzinfo.
Синтаксис
ser.dt.tz
Пример
Давайте создадим Series с datetime-значениями без часового пояса
и проверим атрибут tz:
import pandas as pd
ser = pd.Series(pd.date_range('2026-01-01', periods=3))
print(ser.dt.tz)
Результат выполнения кода:
None
Пример
Теперь добавим часовой пояс с помощью метода tz_localize
и снова проверим атрибут tz:
import pandas as pd
ser = pd.Series(pd.date_range('2026-01-01', periods=3))
ser = ser.dt.tz_localize('Europe/Moscow')
print(ser.dt.tz)
Результат выполнения кода:
Europe/Moscow
Пример
Атрибут tz можно использовать для проверки наличия
часового пояса перед выполнением операций:
import pandas as pd
ser = pd.Series(pd.date_range('2026-01-01', periods=3))
if ser.dt.tz is None:
ser = ser.dt.tz_localize('UTC')
print(ser.dt.tz)
Результат выполнения кода:
UTC
Пример
При конвертации часового пояса атрибут tz обновляется
автоматически:
import pandas as pd
ser = pd.Series(pd.date_range('2026-01-01', periods=3))
ser = ser.dt.tz_localize('Europe/Moscow')
ser = ser.dt.tz_convert('America/New_York')
print(ser.dt.tz)
Результат выполнения кода:
America/New_York
Смотрите также
-
метод
tz_localize,
который устанавливает часовой пояс для datetime-данных -
метод
tz_convert,
который преобразует datetime-данные в другой часовой пояс -
атрибут
date,
который извлекает дату из datetime-значений -
атрибут
time,
который извлекает время из datetime-значений
