pandas.period_range

pandas.period_range(start=None, end=None, periods=None, freq=None, name=None)

返回固定频率的 PeriodIndex。

默认频率是天（日历）。

Parameters:

start字符串、datetime、date、pandas.Timestamp 或类似 period 的对象，默认为 None。

生成 period 的左边界。

end字符串、datetime、date、pandas.Timestamp 或类似 period 的对象，默认为 None。

生成 period 的右边界。

periodsint，默认 None

要生成的周期数。

freqstr 或 DateOffset，可选

频率别名。默认情况下，freq 从 start 或 end 获取，如果它们是 Period 对象。否则，默认值为 "D"，表示每日频率。

namestr，默认 None

生成的 PeriodIndex 的名称。

Returns:

PeriodIndex

Notes

在 start、end 和 periods 这三个参数中，必须指定其中两个。

要了解更多关于频率字符串的信息，请参阅 this link 。

Examples

>>> pd.period_range(start='2017-01-01', end='2018-01-01', freq='M')
PeriodIndex(['2017-01', '2017-02', '2017-03', '2017-04', '2017-05', '2017-06',
         '2017-07', '2017-08', '2017-09', '2017-10', '2017-11', '2017-12',
         '2018-01'],
        dtype='period[M]')

如果 start 或 end 是 Period 对象，它们将作为锚点端点用于 PeriodIndex，其频率与 period_range 构造函数相匹配。

>>> pd.period_range(start=pd.Period('2017Q1', freq='Q'),
...                 end=pd.Period('2017Q2', freq='Q'), freq='M')
PeriodIndex(['2017-03', '2017-04', '2017-05', '2017-06'],
            dtype='period[M]')