WEEK()

返回给定日期或 datetime 表达式所在周次。可选参数 mode（0–7）控制周的起始日和返回值范围。如果 date 为 NULL，则返回 NULL。

函数说明

WEEK() 返回给定日期或 datetime 表达式所在周次。可选参数 mode（0–7）控制周的起始日和返回值范围。如果 date 为 NULL，则返回 NULL。

函数语法

> WEEK(date)
> WEEK(date, mode)

参数释义

参数

说明

date

必要参数。要计算周数的日期或 datetime 表达式。支持 DATE、DATETIME、TIMESTAMP 及字符串类型。

mode

可选参数。0–7 的整数，指定周起始日和返回值范围。省略时默认为 0（周日为起始日，范围 0–53）。

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 week_demo;
CREATE DATABASE week_demo;
USE week_demo;

-- 基本用法：返回周数，默认 mode 0
SELECT WEEK('2026-05-19');

-- mode=1（周一为起始，0-53 范围）
SELECT WEEK('2026-05-19', 1);

-- mode=2（周日为起始，1-53 范围）
SELECT WEEK('2026-05-19', 2);

DROP DATABASE week_demo;

DROP DATABASE IF EXISTS week_tbl_demo;
CREATE DATABASE week_tbl_demo;
USE week_tbl_demo;

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, WEEK(event_date) AS wk FROM events;

DROP DATABASE week_tbl_demo;