WEEKDAY

説明

WEEKDAY 関数は日付の曜日を表す番号を返します。月曜日は 0、火曜日は 1、日曜日は 6 です。

WEEKDAY と DAYOFWEEK の違いに注意してください。

          +-----+-----+-----+-----+-----+-----+-----+
          | Sun | Mon | Tues| Wed | Thur| Fri | Sat |
          +-----+-----+-----+-----+-----+-----+-----+
  weekday |  6  |  0  |  1  |  2  |  3  |  4  |  5  |
          +-----+-----+-----+-----+-----+-----+-----+
dayofweek |  1  |  2  |  3  |  4  |  5  |  6  |  7  |
          +-----+-----+-----+-----+-----+-----+-----+

この関数の動作は MySQL の WEEKDAY 関数と同じです。

構文

WEEKDAY(`<date_or_time_expr>`)

パラメータ

パラメータ	説明
<date_or_time_expr>	日付または日時の入力値。DATE、DATETIME、TIMESTAMP_NS 型に対応します。日時および日付の形式については、日時の変換と日付の変換を参照してください。

戻り値

日付の曜日に対応する番号を INT 型で返します。

• 入力が NULL の場合は NULL を返します。

例

-- 2023-10-09 is Monday, returns 0
SELECT WEEKDAY('2023-10-09'); 
+-------------------------+
| WEEKDAY('2023-10-09')   |
+-------------------------+
| 0                       |
+-------------------------+

-- 2023-10-15 is Sunday, returns 6
SELECT WEEKDAY('2023-10-15 18:30:00'); 
+----------------------------------+
| WEEKDAY('2023-10-15 18:30:00')   |
+----------------------------------+
| 6                                |
+----------------------------------+

-- Input is NULL, returns NULL
SELECT WEEKDAY(NULL);
+---------------+
| WEEKDAY(NULL) |
+---------------+
|          NULL |
+---------------+