pandas.PeriodIndex#

class pandas.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:
dataarray-like (1d int np.ndarray or PeriodArray), optional

Optional period-like data to construct index with.

copybool

Make a copy of input ndarray.

freqstr or period object, optional

One of pandas period strings or corresponding objects.

yearint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

monthint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

quarterint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

dayint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

hourint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

minuteint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

secondint, array, or Series, default None

Deprecated since version 2.2.0: Use PeriodIndex.from_fields instead.

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