DAYOFWEEK_ISO 函数

dayofweek_iso(expr)

功能描述

DAYOFWEEK_ISO 函数用于计算并返回给定日期（date 或 timestamp_ltz 类型）在所属星期的第几天（以整数表示）。星期一对应数字 1，星期日对应数字 7。

参数说明

• expr：输入的日期或时间戳。该参数接受 date 或 timestamp_ltz 类型的值。

返回结果

返回一个整数，表示给定日期在所属星期的第几天。返回结果的范围是 1 到 7，其中 1 表示星期一，2 表示星期二，依此类推，直到 7 表示星期日。

使用示例

1. 计算当前日期是星期几：

SELECT dayofweek_iso(CURRENT_TIMESTAMP());

2. 计算特定日期是星期几：

SELECT dayofweek_iso('2022-03-31');
+-----------------------------+
| dayofweek_iso('2022-03-31') |
+-----------------------------+
| 4                           |
+-----------------------------+

3. 计算一个时间戳是星期几：

SELECT dayofweek_iso(TIMESTAMP "2022-03-31 03:21:00");
+-----+
| res |
+-----+
| 4   |
+-----+

注意事项

• 请确保输入的日期或时间戳格式正确，否则可能导致函数无法正确执行。
• 当输入的时间戳没有日期部分时（例如，只有时间），该函数将根据时间戳的时区信息计算所属星期的第几天。