季度重采样用 resample('q') 表示按季度末对齐(如3月31日),resample('qs') 表示按季度初对齐(如1月1日);若需日历年季度(1–3月等),应显式使用 resample('q-dec')。

季度重采样用 resample('Q') 还是 resample('QS')?
取决于你想要季度的“结束日”还是“起始日”。resample('Q') 默认按自然季度末对齐(如 3月31日、6月30日),而 resample('QS') 按季度初对齐(如 1月1日、4月1日)。如果你原始数据索引是 DatetimeIndex 且含时分秒,Q 会把 2023-03-31 23:59:59 归入 2023Q1,但 QS 会把 2023-04-01 00:00:00 才作为第二季度起点——这点在跨年或月末边界时容易错位。
常见错误现象:df.resample('Q').sum() 算出的 2023Q1 实际包含 2022-12-01 至 2023-03-31 的数据(因为 Q 是“季度末频率”,默认以 12 月为财年末),不是你想的“1–3月”。
- 想严格按日历年季度(1–3、4–6…):用
resample('Q-DEC')(显式指定财年末为12月) - 想按自然季度初聚合(结果时间戳显示为 1月1日、4月1日…):用
resample('QS') - 如果数据本身是月末快照(如财务报表),
resample('Q')通常更合理,但要确认df.index.max()是否真落在季末日
为什么 resample 后时间戳变成季度最后一天?
这是 Pandas 的默认行为:所有周期性重采样频率(Q、M、A)都把结果时间戳对齐到该周期的“终点”。比如 resample('Q') 把 2023-01-15 和 2023-03-20 都归入同一组,并把这组的标签设为 2023-03-31(哪怕那天没数据)。这不是 bug,是设计逻辑——便于和财报日期对齐。
如果你希望标签显示为季度首日(如 2023-01-01),不能靠改频率名,得手动重置:
df_q = df.resample('Q').sum()
df_q.index = df_q.index.to_period('Q').to_timestamp('QS')
注意:to_timestamp('QS') 中的 QS 表示“Quarter Start”,不是字符串拼接;漏掉这个参数会回到默认的季末时间戳。
图片提示词生成器?不止如此。 马甲系统 —— 把脑海中的画面,翻译成AI能理解的专业表达。 用得越多,它越懂你:首次需要多问几句确认方向,用久了几乎一说就懂。 用得越多,它越快:缓存机制让后续对话越来越省。 RAG进化:成功案例持续入库,越跑越聪明。 输入「新手指南」查看完整功能介绍
resample 报错 TypeError: Only valid with DatetimeIndex, TimedeltaIndex or PeriodIndex
说明你的 DataFrame 没有正确的时间索引。Pandas 的 resample 不接受列中带时间的普通 DataFrame,必须把时间列设为索引,且类型是 datetime64[ns]。
- 检查:运行
df.index.dtype,如果不是datetime64[ns],先转索引:df.set_index('date_col', inplace=True) - 再检查类型:
df.index = pd.to_datetime(df.index)(尤其当原始是字符串或 object 类型时) - 如果时间列有空值或非法格式(如
'N/A'),pd.to_datetime(..., errors='coerce')会把它们转成NaT,但resample会跳过这些行——可能造成数据量“莫名减少”
季度聚合后缺失某些季度(比如 2023Q2 没数据)怎么办?
resample 默认只返回有原始数据的季度组,不会补全空档。如果你需要连续季度序列(例如画图或对比),得主动补全:
quarters = pd.period_range(start=df.index.min(), end=df.index.max(), freq='Q')
df_q = df.resample('Q').sum().reindex(quarters.asfreq('Q').to_timestamp())
这里的关键是:period_range 生成完整季度周期,再用 asfreq('Q').to_timestamp() 转成与 resample 输出一致的时间戳类型(否则 reindex 会因类型不匹配失败)。
容易被忽略的一点:补全后的 NaN 值默认是浮点型,如果原数据是整数列,resample 后会自动转成 float64;补全再做 .fillna(0) 可以恢复数值连续性,但要注意是否掩盖了真实缺失。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










