WEEK

傳回指定日期的週數。

用法示範

WEEK(Date)

語法

下列語法會從 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 標準,傳回自年初算起的週數。