周

返回给定日期所在的一周。

用法示例

WEEK(Date)

语法

以下语法会返回日期值的周数。

WEEK( date_expression )

以下语法会从兼容模式日期值返回星期数。

WEEK( 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
WEEK(Date) Jan 1, 2019 1
WEEK(Date as Text, 'BASIC') 2019/01/01-09:40:45 1
WEEK(Date as Number, 'SECONDS') 1561784874 26

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

1562004058620 27

备注

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

此函数根据 ISO 8601 标准返回自年初以来的第几周。