pandas.PeriodIndex

classpandas.PeriodIndex(data=None, ordinal=None, freq=None, dtype=None, copy=False, name=None, **fields)[source]

Immutable ndarray holding ordinal values indicating regular periods in time.

Index keys are boxed to Period objects which carries the metadata (eg, frequency information).

Parameters:

data:array-like (1d int np.ndarray or PeriodArray), optional

Optional period-like data to construct index with.

copy:bool

Make a copy of input ndarray.

freq:str or period object, optional

One of pandas period strings or corresponding objects.

year:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

month:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

quarter:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

day:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

hour:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

minute:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

second:int, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

dtype:str or PeriodDtype, default None

Attributes

day	The days of the period.
dayofweek	The day of the week with Monday=0, Sunday=6.
day_of_week	The day of the week with Monday=0, Sunday=6.
dayofyear	The ordinal day of the year.
day_of_year	The ordinal day of the year.
days_in_month	The number of days in the month.
daysinmonth	The number of days in the month.
end_time	Get the Timestamp for the end of the period.
freqstr	Return the frequency object as a string if it's set, otherwise None.
hour	The hour of the period.
is_leap_year	Logical indicating if the date belongs to a leap year.
minute	The minute of the period.
month	The month as January=1, December=12.
quarter	The quarter of the date.
second	The second of the period.
start_time	Get the Timestamp for the start of the period.
week	The week ordinal of the year.
weekday	The day of the week with Monday=0, Sunday=6.
weekofyear	The week ordinal of the year.
year	The year of the period.

freq
qyear

Methods

asfreq([freq, how])	Convert the PeriodArray to the specified frequency freq.
strftime(*args, **kwargs)	Convert to Index using specified date_format.
to_timestamp([freq, how])	Cast to DatetimeArray/Index.

from_fields
from_ordinals

See also

Index

The base pandas Index type.

Period

Represents a period of time.

DatetimeIndex

Index with datetime64 data.

TimedeltaIndex

Index of timedelta64 data.

period_range

Create a fixed-frequency PeriodIndex.

Examples

>>> idx = pd.PeriodIndex.from_fields(year=[2000, 2002], quarter=[1, 3])
>>> idx
PeriodIndex(['2000Q1', '2002Q3'], dtype='period[Q-DEC]')