pandas.DataFrame.to_period

DataFrame.to_period(freq=None, axis=0, copy=None)[source]

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

Преобразует DataFrame из DatetimeIndex в PeriodIndex с заданной частотой (если частота не передана, она выводится из индекса).

Параметры:

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

Частота PeriodIndex.

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

Ось для преобразования (по умолчанию индекс).

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

Если False, то исходные данные не копируются.

Примечание

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

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

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

DataFrame

DataFrame с PeriodIndex.

Примеры

>>> idx = pd.to_datetime(
...     [
...         "2001-03-31 00:00:00",
...         "2002-05-31 00:00:00",
...         "2003-08-31 00:00:00",
...     ]
... )

>>> idx
DatetimeIndex(['2001-03-31', '2002-05-31', '2003-08-31'],
dtype='datetime64[ns]', freq=None)

>>> idx.to_period("M")
PeriodIndex(['2001-03', '2002-05', '2003-08'], dtype='period[M]')

Для ежегодной частоты

>>> idx.to_period("Y")
PeriodIndex(['2001', '2002', '2003'], dtype='period[Y-DEC]')