pandas.PeriodIndex.asfreq

PeriodIndex.asfreq(self, *args, **kwargs)[source]

Convert the Period Array/Index to the specified frequency freq.

Parameters
freqstr

A frequency.

howstr {‘E’, ‘S’}

Whether the elements should be aligned to the end or start within pa period.

  • ‘E’, ‘END’, or ‘FINISH’ for end,

  • ‘S’, ‘START’, or ‘BEGIN’ for start.

January 31st (‘END’) vs. January 1st (‘START’) for example.

Returns
Period Array/Index

Constructed with the new frequency.

Examples

>>> pidx = pd.period_range('2010-01-01', '2015-01-01', freq='A')
>>> pidx
PeriodIndex(['2010', '2011', '2012', '2013', '2014', '2015'],
dtype='period[A-DEC]', freq='A-DEC')
>>> pidx.asfreq('M')
PeriodIndex(['2010-12', '2011-12', '2012-12', '2013-12', '2014-12',
'2015-12'], dtype='period[M]', freq='M')
>>> pidx.asfreq('M', how='S')
PeriodIndex(['2010-01', '2011-01', '2012-01', '2013-01', '2014-01',
'2015-01'], dtype='period[M]', freq='M')