全部產品
Search
文件中心

MaxCompute:DAYOFWEEK

更新時間:Jun 19, 2024

返回日期的星期值。

命令格式

int dayofweek(datetime|timestamp|date|string <date>)

參數說明

date:必填。DATETIME、TIMESTAMP、DATE或STRING類型日期值,格式為yyyy-mm-ddyyyy-mm-dd hh:mi:ssyyyy-mm-dd hh:mi:ss.ff3。取值為STRING類型格式時,至少要包含yyyy-mm-dd且不含多餘的字串。

傳回值說明

返回INT類型。返回規則如下:

  • date非DATETIME、TIMESTAMP、DATE或STRING類型,或格式不符合要求時,返回NULL。

  • date值為NULL時,返回NULL。

  • 傳回值的取值範圍為1~7,與星期的對應關係為1=Sunday, 2=Monday,...,7=Saturday。

使用樣本

--返回5,即Thursday。
SELECT dayofweek('2009-07-30');

相關函數

DAYOFWEEK函數屬於日期函數,更多日期計算、日期轉換的相關函數請參見日期函數