pandas.period_range

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

返回一个固定频率的 PeriodIndex。

一天（日历）是默认频率。

参数:

开始str, datetime, date, pandas.Timestamp, 或类似周期, 默认 None

生成周期的左边界。

结束str, datetime, date, pandas.Timestamp, 或类似周期, 默认 None

生成周期的右边界。

periodsint, 默认 None

要生成的周期数。

freqstr 或 DateOffset, 可选

频率别名。默认情况下，如果 start 或 end 是 Period 对象，则频率取自这些对象。否则，默认频率为 "D" 表示每日频率。

名称str, 默认 None

生成的 PeriodIndex 的名称。

返回:

PeriodIndex

注释

在三个参数中：start、end 和 periods，必须且只能指定其中两个。

要了解更多关于频率字符串的信息，请参见 此链接。

例子

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