YEARWEEK()
返回给定日期或 datetime 表达式的年份和周数，以整数
YYYYWW格式表示。可选参数mode控制周的编号规则。
语法说明
YEARWEEK() 返回 date 或 datetime 表达式对应的年份和周数，结果为 YYYYWW 格式的整数——例如 202623 表示 2026 年第 23 周。可选参数 mode（0–7）控制周起始日和返回值范围。
语法结构
> YEARWEEK(date)
> YEARWEEK(date, mode)
参数释义
| 参数 | 说明 |
|---|---|
| date | 必填。要计算年周组合的日期或 datetime 表达式。支持 DATE、DATETIME、TIMESTAMP 及字符串类型。若 date 为 NULL，返回 NULL。 |
| mode | 可选。0–7 的整数，指定周起始日和返回值范围。省略时默认为 0。 |
mode 取值表
| Mode | 周起始日 | 返回值范围 | 第 1 周的定义 |
|---|---|---|---|
| 0 | 周日 | 0–53 | 本年中第一个含周日的周 |
| 1 | 周一 | 0–53 | 本年中第一个含 4 天及以上的周 |
| 2 | 周日 | 1–53 | 本年中第一个含周日的周 |
| 3 | 周一 | 1–53 | 本年中第一个含 4 天及以上的周 |
| 4 | 周日 | 0–53 | 本年中第一个含 4 天及以上的周 |
| 5 | 周一 | 0–53 | 本年中第一个含周一的周 |
| 6 | 周日 | 1–53 | 本年中第一个含 4 天及以上的周 |
| 7 | 周一 | 1–53 | 本年中第一个含周一的周 |
示例
DROP DATABASE IF EXISTS yearweek_demo;
CREATE DATABASE yearweek_demo;
USE yearweek_demo;
-- 基本用法：返回 YYYYWW 格式
SELECT YEARWEEK('2026-05-15');
-- 例如 202620
-- mode=1（周一为起始，0-53 范围）
SELECT YEARWEEK('2026-05-15', 1);
CREATE TABLE events (
id INT PRIMARY KEY,
event_date DATE
);
INSERT INTO events VALUES (1, '2026-01-01'), (2, '2026-05-19'), (3, '2026-12-31');
SELECT id, event_date, YEARWEEK(event_date) AS yw FROM events;
DROP DATABASE yearweek_demo;
注意事项
- 返回值为
year * 100 + week。若某年 52 周的某几天落入下一年 1 月，可能返回类似202652的值。 - 当
date为NULL时，函数返回NULL。