DATEPART(quarter, date) 返回1–4的季度值但不区分年份,需配合YEAR()使用以避免跨年分组错误;DATEPART(week, date) 默认周日为起点且第1周含1月1日,与ISO标准不同,应配合SET DATEFIRST或DATEPART(isowk, date)使用。

DATEPART(quarter, date) 提取季度时要注意年份边界
SQL Server 的 DATEPART 函数用 quarter 参数能直接拿到 1–4 的季度值,但它不关心年份切换——比如 '2023-12-31' 和 '2024-01-01' 分属不同年份,但都返回 1(Q1),容易在按“年+季度”分组时漏掉跨年逻辑。
实际使用中,必须显式拼上年份,否则聚合会出错:
SELECT YEAR(OrderDate) AS Year, DATEPART(quarter, OrderDate) AS Quarter, COUNT(*) FROM Orders GROUP BY YEAR(OrderDate), DATEPART(quarter, OrderDate)
-
DATEPART(quarter, ...)返回的是整数,不是字符串,别直接拼接成 '2023Q1' ——要转成字符串得用CONCAT或+配合CAST - PostgreSQL / MySQL 不支持
DATEPART,对应是EXTRACT(QUARTER FROM ...)或QUARTER(),语法不兼容 - SQL Server 2005+ 都支持,但 Azure SQL 和部分旧版 PDW 可能对
quarter参数大小写敏感(建议全小写)
DATEPART(week, date) 的周数默认从周日开始算
DATEPART(week, ...) 在 SQL Server 中默认以周日为每周起点,且第 1 周定义为“包含 1 月 1 日的那一周”,这和 ISO 8601 标准(周一为起点、第 1 周含当年首个周四)完全不同。例如 '2023-01-01' 是周日,它属于 2023 年第 1 周;但 '2024-01-01' 是周一,却可能被算进 2023 年第 53 周(取决于 SET DATEFIRST 设置)。
想对齐业务常用周定义(如周一到周日),得先设基准:
SET DATEFIRST 1; -- 设周一为每周第一天 SELECT DATEPART(week, '2024-01-01'); -- 返回 1(而非默认的 53)
- 该设置只影响当前会话,不是全局配置,存储过程中记得开头加
SET DATEFIRST 1 - 如果用
DATEPART(isowk, ...)(SQL Server 2012+),可直接获取 ISO 周数,但注意它不接受DATEFIRST影响,且isowk必须全小写 - Oracle、SQLite 等数据库无
isowk,需用TO_CHAR(date, 'IW')或自定义计算
季度与周数混合使用时,别直接 GROUP BY 两个 DATEPART
有人会写 GROUP BY DATEPART(quarter, d), DATEPART(week, d),结果发现同个“Q1 第 1 周”出现在多个年份里,数据全混了。季度和周数都是周期性数值,脱离年份毫无业务意义。
- 正确做法是至少带上
YEAR(date),更稳妥是用DATEFROMPARTS(YEAR(d), 1, 1)推算季度起始日,或直接用FORMAT(d, 'yyyy-QQ')(SQL Server 2012+)生成带年份的季度标识 - 周粒度更麻烦:
DATEPART(week, ...)单独用无法区分 2023-W01 和 2024-W01,必须搭配YEAR(...)或ISO_YEAR(SQL Server 2016+ 支持DATEPART(isoyear, ...)) - 若下游是报表工具(如 Power BI),建议在 SQL 层就生成完整时间键,比如
CONCAT(YEAR(d), '-', RIGHT('0' + CAST(DATEPART(week, d) AS VARCHAR(2)), 2)),避免前端再解析
DATEPART 在 WHERE 条件中用错索引很常见
写 WHERE DATEPART(quarter, OrderDate) = 2 看似简洁,但会导致全表扫描——因为函数作用于列,SQL Server 无法利用 OrderDate 上的索引。
- 替代方案是用范围查询:
WHERE OrderDate >= '2024-04-01' AND OrderDate ,这样能走索引 - 如果季度是动态参数(比如传入 @year 和 @quarter),可用
DATEFROMPARTS(@year, (@quarter-1)*3+1, 1)算出季度首日,再推导下季度首日 - 对周数也一样:
DATEPART(week, ...)在 WHERE 中基本等于放弃索引,优先考虑用日期范围或预计算的周起止字段
季度和周数看着简单,但年份归属、周起点、索引友好性这三点,任何一个没对齐,查出来就是错的或者慢得没法忍。

















