pandas.DataFrame.to_period#

DataFrame.to_period(freq=None, ось=0, copy=None)[источник]#

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

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

Параметры:
freqstr, по умолчанию

Частота PeriodIndex.

ось{0 или 'index', 1 или 'columns'}, по умолчанию 0

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

copybool, по умолчанию True

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

Примечание

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

Вы уже можете получить будущее поведение и улучшения, включив copy on write 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]')