pandas.period_range

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

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

По умолчанию частота — дневная (календарная).

Параметры

start:str или period-подобный объект, по умолчанию None

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

end:str или period-подобный объект, по умолчанию None

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

periods:int, по умолчанию None

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

freq:str или DateOffset, необязательно

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

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