创建年度频率的pandas PeriodIndex报错，该如何解决？

问题原因 #

当使用freq="Y"创建PeriodIndex时，仅传入year参数会触发报错，这是因为底层的周期序数生成逻辑需要完整的日期分量（如月份、日期），虽然年度周期本身不需要这些细节，但当前版本的pandas没有为单独的year参数做兼容处理，导致调用底层函数时缺少必要的整数参数，抛出TypeError: an integer is required。

可行解决方案 #

以下几种方法可以正确创建年度频率的PeriodIndex：

1. 直接传递Period对象列表
   最直观的方式，手动构造每个年度Period：

import pandas as pd
idx = pd.PeriodIndex([pd.Period(2000, freq="Y"), pd.Period(2001, freq="Y")])

2. 补充必要的日期字段参数
   给month参数传任意合法月份值（年度周期会忽略具体月份，只保留年份）：

idx = pd.PeriodIndex(year=[2000, 2001], month=[1, 1], freq="Y")

3. 使用period_range快捷生成
   如果是连续的年度范围，用period_range更简洁：

idx = pd.period_range(start=2000, end=2001, freq="Y")

内容的提问来源于stack exchange，提问作者Luca Guarro