maxframe.dataframe.Series.dt.to_period

Series.dt.to_period(freq=None) → PeriodArray

按特定频率转换为 PeriodArray/PeriodIndex。

将 DatetimeArray/Index 转换为 PeriodArray/PeriodIndex。

参数:

freq (str or Period, optional) -- One of pandas' period aliases or a Period object. Will be inferred by default.

返回:

Immutable ndarray holding ordinal values at a particular frequency.

返回类型:

PeriodArray/PeriodIndex

抛出:

ValueError -- 当转换包含非规律值的 DatetimeArray/Index 时，无法推断频率。

参见

PeriodIndex

保存序数值的不可变 ndarray。

DatetimeIndex.to_pydatetime

将 DatetimeIndex 作为对象返回。

示例

>>> import maxframe.dataframe as md
>>> df = md.DataFrame(
...     {"y": [1, 2, 3]},
...     index=md.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").execute()
PeriodIndex(['2000-03', '2000-05', '2000-08'],
            dtype='period[M]')

推断每日频率

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