pandas.arrays.DatetimeArray.to_period

DatetimeArray.to_period(freq=None) [source]

Преобразование в PeriodArray/Index с указанной частотой.

Преобразует DatetimeArray/Index в PeriodArray/Index.

Параметры:	freq : string or Offset, optional Один из строковых представлений сдвигов pandas или объект Offset. По умолчанию будет определен автоматически.
Возвращает:	PeriodArray/Index
Исключения:	ValueError При преобразовании DatetimeArray/Index с нерегулярными значениями, когда невозможно определить частоту.

См. также

PeriodIndex

Неизменяемый массив ndarray, содержащий порядковые значения.

DatetimeIndex.to_pydatetime

Возвращает DatetimeIndex как объект.

Примеры

>>> df = pd.DataFrame({"y": [1,2,3]},
...                   index=pd.to_datetime(["2000-03-31 00:00:00",
...                                         "2000-05-31 00:00:00",
...                                         "2000-08-31 00:00:00"]))
>>> df.index.to_period("M")
PeriodIndex(['2000-03', '2000-05', '2000-08'],
            dtype='period[M]', freq='M')

Определение частоты по умолчанию (ежедневно)

>>> idx = pd.date_range("2017-01-01", periods=2)
>>> idx.to_period()
PeriodIndex(['2017-01-01', '2017-01-02'],
            dtype='period[D]', freq='D')