WEEKOFYEAR

📄字数 374

👁️阅读量 加载中...

功能描述

返回日期是所在年份的第几周。等同于 WEEK(date, 3)，即国际标准（ISO 8601）。

语法格式

WEEKOFYEAR(expr)

输入参数

• expr：DATE 或 TIME 类型，当参数为 TIME 类型时，其对应的日期为当前系统日期。

提示

• 因 NULL 无具体的类型，所以当参数为 NULL 时，会产生异常 E10100 候选函数出现多义性，需要手动为参数指定具体的类型，如：WEEKOFYEAR(NULL::DATE)。

输出结果

返回 TINYINT 类型，返回值范围：[1, 53]，输入参数为 NULL 时，输出结果为 NULL。

示例

-- 返回 '2023-03-16' 在所属年份的第几周
SQL> SELECT WEEKOFYEAR('2023-03-16');

+-------+
| EXPR1 |
+-------+
| 11    |
+-------+

-- 返回 '2025-07-03 10:00:00' 在所属年份的第几周
SQL> SELECT WEEKOFYEAR('2025-07-03 10:00:00');

+-------+
| EXPR1 |
+-------+
| 27    |
+-------+