WEEKDAY

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

用法示例

WEEKDAY(Date)

语法

以下语法会返回一个数字，表示 Date 值对应的星期几。

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：例如，2008 年 5 月 24 日（星期六）20:09:47（格林尼治标准时间）
  • RFC_3339：例如，2008-05-24T20:09:47Z
  • DECIMAL_DATE：与 DEFAULT_DECIMAL 相同

接受任何有效的 strptime 格式。

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

  • SECONDS：自公元纪年以来的秒数
  • MILLIS：自公元纪年以来的毫秒数
  • MICROS：自公元纪年以来的微秒数
  • NANOS：自公元纪年以来的纳秒数
  • JULIAN_DATE：自公元纪年以来的天数

示例

Example formula Input Output
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，因此星期六的值为 6。