pandas.Series.to_period

Series.to_period(freq=None, copy=None)[source]

Преобразование Series из DatetimeIndex в PeriodIndex.

Параметры:

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

Частота, связанная с PeriodIndex.

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

Возвращать копию или нет.

Примечание

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

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

Возвращает:

Series

Series с индексом, преобразованным в PeriodIndex.

Примеры

>>> idx = pd.DatetimeIndex(['2023', '2024', '2025'])
>>> s = pd.Series([1, 2, 3], index=idx)
>>> s = s.to_period()
>>> s
2023    1
2024    2
2025    3
Freq: Y-DEC, dtype: int64

Просмотр индекса

>>> s.index
PeriodIndex(['2023', '2024', '2025'], dtype='period[Y-DEC]')