WEEKDAY

返回一个数字，表示给定日期所在的星期几。

用法示例

WEEKDAY(Date)

语法

以下语法会返回一个介于 0 到 6 之间的数字（从星期日开始），表示一周中的某天。

WEEKDAY( date_expression )

以下语法会返回一个数字，表示兼容模式日期值所在的星期几。

WEEKDAY( X [, format_string ])

参数

  • date_expression - 日期和时间字段或表达式。
  • X - 计算结果为“文本”“数字”或兼容模式日期的字段或表达式。
  • format_string - X 的格式。如果 X 正确配置为语义日期字段，则为可选。

兼容模式日期的输入格式

如果 X 是文本字段或表达式，或者兼容模式日期，则受支持的日期函数接受以下输入格式：

  • BASIC：%Y/%m/%d-%H:%M:%S
  • DEFAULT_DASH：%Y-%m-%d [%H:%M:%S]
  • DEFAULT_SLASH：%Y/%m/%d [%H:%M:%S]
  • DEFAULT_DECIMAL：%Y%m%d [%H:%M:%S]
  • RFC_1123：例如，Sat, 24 May 2008 20:09:47 GMT
  • RFC_3339：例如，2008-05-24T20:09:47Z
  • DECIMAL_DATE：与 DEFAULT_DECIMAL 相同

系统接受任何有效的 strptime 格式。

如果 X 是数字字段或表达式，则支持的时间函数接受以下输入格式：

  • SECONDS：自 Epoch 以来的秒数
  • MILLIS：自 Epoch 以来的毫秒数
  • MICROS：自 Epoch 以来的微秒数
  • NANOS：自 Epoch 以来的纳秒数
  • JULIAN_DATE：自 Epoch 以来的天数

示例

示例公式 输入 输出
WEEKDAY(Date) Jan 1, 2019 2
WEEKDAY(Date as Text, 'BASIC') 2019/01/01-09:40:45 2
WEEKDAY(Date as Number, 'SECONDS') 1561784874 6

WEEKDAY(Date as lots of Numbers, 'MILLIS')

1562004058620 1

备注

此函数可用于兼容模式日期以及升级后的“日期”和“日期和时间”数据类型。

下表介绍了此函数的可能输出：

数字 天
0 星期日
1 星期一
2 星期二
3 星期三
4 星期四
5 星期五
6 星期六