pandas.DatetimeIndex.to_period

DatetimeIndex.to_period(*args, **kwargs)[source]

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

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

Параметры

freq:строка или смещение, необязательно

Одно из строковых обозначений смещений pandas или объект смещения. По умолчанию будет определён автоматически.

Возвращает

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]')

Определение частоты «день»

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