WEEK

返回给定日期的周数。

用法示例

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：例如，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 以来的天数

示例

示例公式 输入 输出
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 标准返回自年初以来经过的周数。