全部产品
Search
文档中心

云原生大数据计算服务 MaxCompute:DAYOFWEEK

更新时间:Jun 15, 2023

返回日期的星期值。

命令格式

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函数属于日期函数,更多日期计算、日期转换的相关函数请参见日期函数