大网数据广告活动
数据库部署与 SQL 参考

Apache Doris 中文参考:WEEK

· 52CE 我爱测

WEEK 函数用于返回指定日期对应的星期数,默认 Mode 为 0,支持通过 mode 参数自定义星期计算规则(如星期的第一天是周日还是周一、星期数的范围、第一个星期的判定标准等)。 参数 mode 的作用参见下面的表格:

描述

WEEK 函数用于返回指定日期对应的星期数,默认 Mode 为 0,支持通过 mode 参数自定义星期计算规则(如星期的第一天是周日还是周一、星期数的范围、第一个星期的判定标准等)。 参数 mode 的作用参见下面的表格:

Mode 星期的第一天 星期数的范围 第一个星期的定义
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 这一年中的第一个星期一所在的星期

该函数与 mysql 中的 week函数 行为一致。

语法

WEEK(`<date_or_time_expr>`)
WEEK(`<date_or_time_expr>`,`<mode>`)

参数

参数 描述
<datetime_or_date> 输入的日期时间值,支持输入 DATE/DATETIME/TIMESTAMP_NS 类型,具体 datetime 和 date 格式请查看 datetime 的转换 和 date 的转换
<mode> 可选,INT 类型,默认值为 0。计算规则由 mode & 7 决定,对应上表中的模式 0-7。

返回值

返回类型为 INT,表示指定日期对应的星期数,具体范围由 <mode> 决定(0-53 或 1-53)。

  • 若 <mode> 为非 0-7 的整数,则使用其低 3 位(mode & 7)对应的模式计算。例如,8 对应模式 0,9 对应模式 1,-1 对应模式 7;
  • 若任一参数为 NULL,返回 NULL;
  • 跨年日期可能返回上一年的最后一周(如 2023 年 1 月 1 日在部分模式下属于 2022 年第 52 周)。

举例

越界 mode 使用其低 3 位。例如,8 对应模式 0:

SELECT WEEK('2021-01-01', 8) AS mode_8,
       WEEK('2021-01-01', 0) AS mode_0,
       WEEK('2021-01-01', 7) AS mode_7;
+--------+--------+--------+
| mode_8 | mode_0 | mode_7 |
+--------+--------+--------+
|      0 |      0 |     52 |
+--------+--------+--------+

-- 2020-01-01是星期三,当年第一个周日是2020-01-05,故属于第0周
SELECT WEEK('2020-01-01') AS week_result;
+-------------+
| week_result |
+-------------+
|           0 |
+-------------+

-- 2020-07-01是星期三,所在周包含≥4天属于2020年,为第27周
SELECT WEEK('2020-07-01', 1) AS week_result;
+-------------+
| week_result |
+-------------+
|          27 |
+-------------+

-- 对比mode=0和mode=3(不同规则的差异)
SELECT 
  WEEK('2023-01-01', 0) AS mode_0, 
  WEEK('2023-01-01', 3) AS mode_3;  
+--------+--------+
| mode_0 | mode_3 |
+--------+--------+
|      1 |     52 |
+--------+--------+

-- 2023年第一个周一是1月2日,故2023-01-01属于2022年第52周
SELECT WEEK('2023-01-01', 7) AS week_result;
+-------------+
| week_result |
+-------------+
|          52 |
+-------------+

-- -1 & 7 = 7,因此使用模式 7
SELECT WEEK('2023-01-01', -1) AS week_result;
+-------------+
| week_result |
+-------------+
|          52 |
+-------------+

-- 输入为DATETIME类型(忽略时间部分)
SELECT WEEK('2023-12-31 23:59:59', 3) AS week_result;
+-------------+
| week_result |
+-------------+
|          52 |  
+-------------+

---任意参数为 NULL ,结果返回 NULL
SELECT WEEK('2023-12-31 23:59:59', NULL),WEEK(NULL,3);
+-----------------------------------+--------------+
| WEEK('2023-12-31 23:59:59', NULL) | WEEK(NULL,3) |
+-----------------------------------+--------------+
|                              NULL |         NULL |
+-----------------------------------+--------------+

本文来自 Apache Doris 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
Apache Doris 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。