季度重采样用 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），不能靠改频率名，得手动重置：
立即学习“Python免费学习笔记（深入）”；
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
df_q = df.resample('Q').sum()
df_q.index = df_q.index.to_period('Q').to_timestamp('QS')
注意：to_timestamp('QS') 中的 QS 表示“Quarter Start”，不是字符串拼接；漏掉这个参数会回到默认的季末时间戳。
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) 可以恢复数值连续性，但要注意是否掩盖了真实缺失。
