WEEK

傳回特定日期的週數。

用法示範

WEEK(Date)

語法

下列語法會從日期值傳回週數。

WEEK( date_expression )

下列語法會從相容性模式的日期值傳回週數。

WEEK( X [, format_string ])

參數

  • date_expression - 日期和時間欄位或運算式。
  • X - 評估結果為文字、數字或相容性模式日期的欄位或運算式。
  • 目前為「X」選取了 format_string 匯出格式。如果 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 標準，傳回自年初算起的週數。