最稳妥方式是直接对datetime64类型series调用.dt访问器提取年、季、月、iso周、星期几等属性；须先用pd.to_datetime()转换非datetime列，禁用已弃用的.dt.week，改用.dt.isocalendar().week，并优先使用.dt.quarter而非手动计算季度。
用 dt 访问器直接取年、季、月、周等属性最稳妥
直接对 datetime64 类型的 Series 调用 .dt，再链式访问属性（如 .dt.year），是 Pandas 提取时间特征的首选方式。它底层调用的是 NumPy 的 datetime64 运算，速度快、结果确定、不依赖字符串解析。
常见错误是先用 strftime 转成字符串再切片（比如 df['date'].dt.strftime('%Y-%m').str[:4]），这不仅慢，还容易因格式不一致出错。另外，.dt 只对 datetime64 或 period 类型有效；如果列是 object 类型（即字符串），必须先用 pd.to_datetime() 转换，否则会报 AttributeError: Can only use .dt accessor with datetimelike values。
-
df['date'].dt.year→ 返回 int64 年份（如 2023） -
df['date'].dt.quarter→ 返回 int64 季度（1–4） -
df['date'].dt.month→ 返回 int64 月份（1–12） -
df['date'].dt.week→ 返回 int64 周序号（ISO 周，从 1 开始） -
df['date'].dt.dayofweek→ 返回 int64 星期几（Monday=0, Sunday=6）
注意 dt.week 和 dt.isocalendar().week 的区别
df['date'].dt.week 在较新 Pandas 版本（≥1.1）中已被弃用，会触发 FutureWarning；推荐改用 df['date'].dt.isocalendar().week。两者都返回 ISO 周数，但 .isocalendar() 是一个 DataFrame，包含 year、week、day 三列，更完整也更明确。
如果你只要周数，写法是：df['date'].dt.isocalendar().week；如果还要同时提取 ISO 年和周，可以一步拿到：df['date'].dt.isocalendar()[['year', 'week']]。旧写法 .dt.week 在 Pandas 2.0+ 已彻底移除，线上代码务必检查。
- 错误示例：
df['date'].dt.week（Pandas ≥2.0 报AttributeError） - 正确替代：
df['date'].dt.isocalendar().week - ISO 周定义：每年第一个周四所在周为第 1 周，因此 2023-01-01（周日）属于 2022 年第 52 周
季度不能只靠 month//3+1，得用 .dt.quarter
有人试图用 (df['date'].dt.month // 3) + 1 算季度，逻辑看似成立，但会出错：12 月（month=12）→ 12//3+1 = 5，显然不对。Python 整除是向下取整，而季度划分是 [1–3]=Q1、[4–6]=Q2、[7–9]=Q3、[10–12]=Q4，手动计算容易边界翻车。
.dt.quarter 内部按标准季度映射，稳定可靠。它返回的是整数，不是字符串（如不会返回 "Q1"），如需字符串格式，可后续拼接：'Q' + df['date'].dt.quarter.astype(str)。注意 .dt.quarter 对 NaT 返回 NaN，类型为 float64，若需保持 int，要额外处理缺失值。
- ✅ 正确：
df['date'].dt.quarter - ❌ 危险：
(df['date'].dt.month // 3) + 1 - ⚠️ 注意：
.dt.quarter结果含NaN，转 int 前建议先.fillna(0).astype('int32')
提取周开始日、月末日这类“锚点日期”要用 .dt.to_period() 或 .dt.floor()
单纯取“第几周”不够用，业务常需“这周的周一在哪天”或“这个月最后一天是几号”。这时不能靠 .dt.week 反推，而应借助 .dt.to_period() 转为周期，再用 .start_time / .end_time 属性，或用 .dt.floor() / .dt.ceil() 向下/向上取整。
例如：获取每周一日期 → df['date'].dt.to_period('W-MON').start_time.dt.date；获取当月最后一天 → df['date'].dt.to_period('M').end_time.dt.date。注意 to_period('W-MON') 中的 W-MON 表示以周一为每周起点，若用默认 'W'，则以周日为起点，结果不同。
- 周起始日（周一）：
df['date'].dt.to_period('W-MON').start_time.dt.date - 月结束日：
df['date'].dt.to_period('M').end_time.dt.date - 向下取整到小时：
df['date'].dt.floor('H')（保留年月日时，分秒归零） - 所有
.to_period()返回的是PeriodIndex，必须加.start_time或.end_time才能转回 timestamp
datetime64 类型，且优先用 .dt 原生属性而非字符串操作。ISO 周、季度、锚点日期这些概念在不同库中定义不一，Pandas 的 .dt 实现是自洽的，但得看准文档版本——尤其 .dt.week 这种被删掉的接口，老代码迁移时最容易漏掉。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
