WEEKDAY

以數字形式傳回特定日期是星期幾。

用法示範

WEEKDAY(Date)

語法

下列語法會從「日期」值傳回代表星期幾的數字。

WEEKDAY( date_expression )

下列語法會從相容性模式的日期值傳回代表星期幾的數字。

WEEKDAY( 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 以來的日數

範例

範例公式 輸入 輸出
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。