weekday：返回星期几

速查结论

weekday(date) 是 Spark SQL 中用于**返回日期对应的星期几（0=周一，6=周日）**的函数。

语法

weekday(date)

参数说明

参数	类型	说明
date	DATE / TIMESTAMP / STRING	一个日期或时间戳值。函数返回该日期在星期中的序号。

Examples

> SELECT weekday('2009-07-30');
 3

常见报错与避坑指南

• 与 dayofweek 的区别：weekday 返回 0-6（周一=0，周日=6），而 dayofweek 返回 1-7（周日=1，周六=7）。选择时需注意两者的起始日和编号差异。
• 传入 NULL 值：如果 date 为 NULL，函数返回 NULL。
• 字符串日期格式：传入字符串时应使用标准日期格式（如 yyyy-MM-dd），否则可能返回 NULL。

Since: 2.4.0

📱关注公众号

「数据仓库技术」文章同步更新，不错过每一篇干货

💬加群交流

备注「数据仓库技术」加入社群，每日一道大厂SQL真题