DAYOFWEEK

説明

DAYOFWEEK関数は、日付または時刻式に対応する曜日のインデックス値を返すために使用されます。日曜日が1、月曜日が2、...、土曜日が7というルールに従います。

この関数はMySQLのdayofweek functionと一貫した動作をします

エイリアス

• DOW

構文

DAYOFWEEK(<date_or_time_expr>)

パラメータ

Parameter	デスクリプション
<date_or_time_expr>	date/datetimeタイプをサポートする有効な日付式。特定のdatetimeおよびdateフォーマットについては、datetime conversionおよびdate conversionを参照してください

戻り値

日付に対応する曜日インデックス値を表す整数を返します（1-7、1は日曜日、7は土曜日を表す）。

特殊ケース：

<date_or_time_expr>がNULLの場合、NULLを返します；

Examples

---Calculate weekday index value for date type
select dayofweek('2019-06-25');

+----------------------------------+
| dayofweek('2019-06-25 00:00:00') |
+----------------------------------+
|                                3 |
+----------------------------------+

---Calculate weekday index value for datetime type
select dayofweek('2019-06-25 15:30:45');

+----------------------------------+
| dayofweek('2019-06-25 15:30:45') |
+----------------------------------+
|                                3 |
+----------------------------------+
---Index for Sunday
select dayofweek('2024-02-18');
+-------------------------+
| dayofweek('2024-02-18') |
+-------------------------+
|                       1 |
+-------------------------+

---Input datetime is NULL, returns NULL
select dayofweek(NULL);
+-----------------+
| dayofweek(NULL) |
+-----------------+
|            NULL |
+-----------------+