Skip to main content
Ctrl+K
pandas 3.0.0.dev0+2097.gcdc5b7418e documentation - Home pandas 3.0.0.dev0+2097.gcdc5b7418e documentation - Home
  • Getting started
  • User Guide
  • API reference
  • Development
  • Release notes
  • GitHub
  • X
  • Mastodon
  • Getting started
  • User Guide
  • API reference
  • Development
  • Release notes
  • GitHub
  • X
  • Mastodon
  • Input/output
  • General functions
  • Series
  • DataFrame
  • pandas arrays, scalars, and data types
  • Index objects
    • pandas.Index
    • pandas.Index.values
    • pandas.Index.is_monotonic_increasing
    • pandas.Index.is_monotonic_decreasing
    • pandas.Index.is_unique
    • pandas.Index.has_duplicates
    • pandas.Index.hasnans
    • pandas.Index.dtype
    • pandas.Index.inferred_type
    • pandas.Index.shape
    • pandas.Index.name
    • pandas.Index.names
    • pandas.Index.nbytes
    • pandas.Index.ndim
    • pandas.Index.size
    • pandas.Index.empty
    • pandas.Index.T
    • pandas.Index.memory_usage
    • pandas.Index.array
    • pandas.Index.all
    • pandas.Index.any
    • pandas.Index.argmin
    • pandas.Index.argmax
    • pandas.Index.copy
    • pandas.Index.delete
    • pandas.Index.drop
    • pandas.Index.drop_duplicates
    • pandas.Index.duplicated
    • pandas.Index.equals
    • pandas.Index.factorize
    • pandas.Index.identical
    • pandas.Index.insert
    • pandas.Index.is_
    • pandas.Index.min
    • pandas.Index.max
    • pandas.Index.reindex
    • pandas.Index.rename
    • pandas.Index.repeat
    • pandas.Index.where
    • pandas.Index.take
    • pandas.Index.putmask
    • pandas.Index.unique
    • pandas.Index.nunique
    • pandas.Index.value_counts
    • pandas.Index.set_names
    • pandas.Index.droplevel
    • pandas.Index.fillna
    • pandas.Index.dropna
    • pandas.Index.isna
    • pandas.Index.notna
    • pandas.Index.astype
    • pandas.Index.item
    • pandas.Index.map
    • pandas.Index.ravel
    • pandas.Index.to_list
    • pandas.Index.to_series
    • pandas.Index.to_frame
    • pandas.Index.to_numpy
    • pandas.Index.view
    • pandas.Index.argsort
    • pandas.Index.searchsorted
    • pandas.Index.sort_values
    • pandas.Index.shift
    • pandas.Index.append
    • pandas.Index.join
    • pandas.Index.intersection
    • pandas.Index.union
    • pandas.Index.difference
    • pandas.Index.symmetric_difference
    • pandas.Index.asof
    • pandas.Index.asof_locs
    • pandas.Index.get_indexer
    • pandas.Index.get_indexer_for
    • pandas.Index.get_indexer_non_unique
    • pandas.Index.get_level_values
    • pandas.Index.get_loc
    • pandas.Index.get_slice_bound
    • pandas.Index.isin
    • pandas.Index.slice_indexer
    • pandas.Index.slice_locs
    • pandas.RangeIndex
    • pandas.RangeIndex.start
    • pandas.RangeIndex.stop
    • pandas.RangeIndex.step
    • pandas.RangeIndex.from_range
    • pandas.CategoricalIndex
    • pandas.CategoricalIndex.codes
    • pandas.CategoricalIndex.categories
    • pandas.CategoricalIndex.ordered
    • pandas.CategoricalIndex.rename_categories
    • pandas.CategoricalIndex.reorder_categories
    • pandas.CategoricalIndex.add_categories
    • pandas.CategoricalIndex.remove_categories
    • pandas.CategoricalIndex.remove_unused_categories
    • pandas.CategoricalIndex.set_categories
    • pandas.CategoricalIndex.as_ordered
    • pandas.CategoricalIndex.as_unordered
    • pandas.CategoricalIndex.map
    • pandas.CategoricalIndex.equals
    • pandas.IntervalIndex
    • pandas.IntervalIndex.from_arrays
    • pandas.IntervalIndex.from_tuples
    • pandas.IntervalIndex.from_breaks
    • pandas.IntervalIndex.left
    • pandas.IntervalIndex.right
    • pandas.IntervalIndex.mid
    • pandas.IntervalIndex.closed
    • pandas.IntervalIndex.length
    • pandas.IntervalIndex.values
    • pandas.IntervalIndex.is_empty
    • pandas.IntervalIndex.is_non_overlapping_monotonic
    • pandas.IntervalIndex.is_overlapping
    • pandas.IntervalIndex.get_loc
    • pandas.IntervalIndex.get_indexer
    • pandas.IntervalIndex.set_closed
    • pandas.IntervalIndex.contains
    • pandas.IntervalIndex.overlaps
    • pandas.IntervalIndex.to_tuples
    • pandas.MultiIndex
    • pandas.MultiIndex.from_arrays
    • pandas.MultiIndex.from_tuples
    • pandas.MultiIndex.from_product
    • pandas.MultiIndex.from_frame
    • pandas.MultiIndex.names
    • pandas.MultiIndex.levels
    • pandas.MultiIndex.codes
    • pandas.MultiIndex.nlevels
    • pandas.MultiIndex.levshape
    • pandas.MultiIndex.dtypes
    • pandas.MultiIndex.set_levels
    • pandas.MultiIndex.set_codes
    • pandas.MultiIndex.to_flat_index
    • pandas.MultiIndex.to_frame
    • pandas.MultiIndex.sortlevel
    • pandas.MultiIndex.droplevel
    • pandas.MultiIndex.swaplevel
    • pandas.MultiIndex.reorder_levels
    • pandas.MultiIndex.remove_unused_levels
    • pandas.MultiIndex.drop
    • pandas.MultiIndex.copy
    • pandas.MultiIndex.append
    • pandas.MultiIndex.truncate
    • pandas.MultiIndex.get_loc
    • pandas.MultiIndex.get_locs
    • pandas.MultiIndex.get_loc_level
    • pandas.MultiIndex.get_indexer
    • pandas.MultiIndex.get_level_values
    • pandas.IndexSlice
    • pandas.DatetimeIndex
    • pandas.DatetimeIndex.year
    • pandas.DatetimeIndex.month
    • pandas.DatetimeIndex.day
    • pandas.DatetimeIndex.hour
    • pandas.DatetimeIndex.minute
    • pandas.DatetimeIndex.second
    • pandas.DatetimeIndex.microsecond
    • pandas.DatetimeIndex.nanosecond
    • pandas.DatetimeIndex.date
    • pandas.DatetimeIndex.time
    • pandas.DatetimeIndex.timetz
    • pandas.DatetimeIndex.dayofyear
    • pandas.DatetimeIndex.day_of_year
    • pandas.DatetimeIndex.dayofweek
    • pandas.DatetimeIndex.day_of_week
    • pandas.DatetimeIndex.weekday
    • pandas.DatetimeIndex.quarter
    • pandas.DatetimeIndex.tz
    • pandas.DatetimeIndex.freq
    • pandas.DatetimeIndex.freqstr
    • pandas.DatetimeIndex.is_month_start
    • pandas.DatetimeIndex.is_month_end
    • pandas.DatetimeIndex.is_quarter_start
    • pandas.DatetimeIndex.is_quarter_end
    • pandas.DatetimeIndex.is_year_start
    • pandas.DatetimeIndex.is_year_end
    • pandas.DatetimeIndex.is_leap_year
    • pandas.DatetimeIndex.inferred_freq
    • pandas.DatetimeIndex.indexer_at_time
    • pandas.DatetimeIndex.indexer_between_time
    • pandas.DatetimeIndex.normalize
    • pandas.DatetimeIndex.strftime
    • pandas.DatetimeIndex.snap
    • pandas.DatetimeIndex.tz_convert
    • pandas.DatetimeIndex.tz_localize
    • pandas.DatetimeIndex.round
    • pandas.DatetimeIndex.floor
    • pandas.DatetimeIndex.ceil
    • pandas.DatetimeIndex.month_name
    • pandas.DatetimeIndex.day_name
    • pandas.DatetimeIndex.as_unit
    • pandas.DatetimeIndex.to_period
    • pandas.DatetimeIndex.to_pydatetime
    • pandas.DatetimeIndex.to_series
    • pandas.DatetimeIndex.to_frame
    • pandas.DatetimeIndex.mean
    • pandas.DatetimeIndex.std
    • pandas.TimedeltaIndex
    • pandas.TimedeltaIndex.days
    • pandas.TimedeltaIndex.seconds
    • pandas.TimedeltaIndex.microseconds
    • pandas.TimedeltaIndex.nanoseconds
    • pandas.TimedeltaIndex.components
    • pandas.TimedeltaIndex.inferred_freq
    • pandas.TimedeltaIndex.as_unit
    • pandas.TimedeltaIndex.to_pytimedelta
    • pandas.TimedeltaIndex.to_series
    • pandas.TimedeltaIndex.round
    • pandas.TimedeltaIndex.floor
    • pandas.TimedeltaIndex.ceil
    • pandas.TimedeltaIndex.to_frame
    • pandas.TimedeltaIndex.mean
    • pandas.PeriodIndex
    • pandas.PeriodIndex.day
    • pandas.PeriodIndex.dayofweek
    • pandas.PeriodIndex.day_of_week
    • pandas.PeriodIndex.dayofyear
    • pandas.PeriodIndex.day_of_year
    • pandas.PeriodIndex.days_in_month
    • pandas.PeriodIndex.daysinmonth
    • pandas.PeriodIndex.end_time
    • pandas.PeriodIndex.freq
    • pandas.PeriodIndex.freqstr
    • pandas.PeriodIndex.hour
    • pandas.PeriodIndex.is_leap_year
    • pandas.PeriodIndex.minute
    • pandas.PeriodIndex.month
    • pandas.PeriodIndex.quarter
    • pandas.PeriodIndex.qyear
    • pandas.PeriodIndex.second
    • pandas.PeriodIndex.start_time
    • pandas.PeriodIndex.week
    • pandas.PeriodIndex.weekday
    • pandas.PeriodIndex.weekofyear
    • pandas.PeriodIndex.year
    • pandas.PeriodIndex.asfreq
    • pandas.PeriodIndex.strftime
    • pandas.PeriodIndex.to_timestamp
    • pandas.PeriodIndex.from_fields
    • pandas.PeriodIndex.from_ordinals
  • Date offsets
  • Window
  • GroupBy
  • Resampling
  • Style
  • Plotting
  • Options and settings
  • Extensions
  • Testing
  • Missing values
  • API reference
  • Index objects
  • pandas.PeriodIndex
  • pandas.PeriodIndex.year

pandas.PeriodIndex.year#

property PeriodIndex.year[source]#

The year of the period.

See also

PeriodIndex.day_of_year

The ordinal day of the year.

PeriodIndex.dayofyear

The ordinal day of the year.

PeriodIndex.is_leap_year

Logical indicating if the date belongs to a leap year.

PeriodIndex.weekofyear

The week ordinal of the year.

PeriodIndex.year

The year of the period.

Examples

>>> idx = pd.PeriodIndex(["2023", "2024", "2025"], freq="Y")
>>> idx.year
Index([2023, 2024, 2025], dtype='int64')

previous

pandas.PeriodIndex.weekofyear

next

pandas.PeriodIndex.asfreq

On this page
  • PeriodIndex.year

This Page

  • Show Source

© 2025, pandas via NumFOCUS, Inc. Hosted by OVHcloud.

Created using Sphinx 8.1.3.

Built with the PyData Sphinx Theme 0.16.1.