pandas.period_range

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

Возвращает PeriodIndex с фиксированной частотой.

По умолчанию используется частота дня (календарного дня).

Параметры:

start:строка, datetime, дата, pandas.Timestamp или период-подобный объект, по умолчанию None

Левая граница для генерации периодов.

end:строка, datetime, дата, pandas.Timestamp или период-подобный объект, по умолчанию None

Правая граница для генерации периодов.

periods:целое число, по умолчанию None

Количество периодов для генерации.

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

Алиас частоты. По умолчанию частота берётся из start или end, если это объекты Period. В противном случае, по умолчанию используется "D" для ежедневной частоты.

name:строка, по умолчанию 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]')