WEEKOFYEAR

📄字数 489

👁️阅读量 加载中...

功能描述

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

语法格式

WEEKOFYEAR(expr)

输入参数

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

提示

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

输出结果

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

执行类型

TYPE	VALUE	说明
NATIVE	0	函数只能在本地计算
VOLATI	0	函数的每次计算值不同
STABLE	0	函数的每次计算值相同
COMPUTE	0	函数支持预计算取值
NOT_CONST	0	函数不支持转常数
HAVE_DEF	0	函数参数有默认值

示例

-- 返回 '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    |
+-------+