メインコンテンツまでスキップ
に最終更新

WEEK

説明​

WEEK 関数は、指定した日付の週番号を返します。デフォルトのモードは 0 です。mode パラメータで、週の初日を日曜日と月曜日のどちらにするか、週番号の範囲、年の最初の週の判定基準など、週番号の計算規則を指定できます。

mode パラメータの設定と効果を次の表に示します。

モード週の初日週番号の範囲年の最初の週の定義
0日曜日0-53その年の最初の日曜日を含む週
1月曜日0-53その年に属する日が 4 日以上ある最初の週
2日曜日1-53その年の最初の日曜日を含む週
3月曜日1-53その年に属する日が 4 日以上ある最初の週
4日曜日0-53その年に属する日が 4 日以上ある最初の週
5月曜日0-53その年の最初の月曜日を含む週
6日曜日1-53その年に属する日が 4 日以上ある最初の週
7月曜日1-53その年の最初の月曜日を含む週

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

構文​

WEEK(`<date_or_time_expr>`)
WEEK(`<date_or_time_expr>`, `<mode>`)

パラメータ​

パラメータ説明
<date_or_time_expr>入力する日時値。DATE、DATETIME、TIMESTAMP_NS 型に対応します。日時と日付の形式については、日時の変換と日付の変換を参照してください。
<mode>省略可能な INT 型の値。デフォルトは 0 です。mode & 7 で計算規則が決まり、上の表のモード 0～7 から選択されます。

戻り値​

指定した日付の週番号を表す INT 型の値を返します。範囲は <mode> によって 0-53 または 1-53 になります。

  • <mode> が 0～7 の範囲外の整数の場合、下位三ビット（mode & 7）で計算モードが決まります。たとえば、8 はモード 0、9 はモード 1、-1 はモード 7 を選択します。
  • いずれかのパラメータが NULL の場合、NULL を返します。
  • 年をまたぐ日付では、前年の最後の週の番号を返すことがあります（たとえば、モードによっては 2023 年 1 月の元日は 2022 年の第 52 週に属します）。

例​

範囲外のモード値では、下位三ビットを使用します。たとえば、8 はモード 0 を選択します。

SELECT WEEK('2021-01-01', 8) AS mode_8,
       WEEK('2021-01-01', 0) AS mode_0,
       WEEK('2021-01-01', 7) AS mode_7;
+--------+--------+--------+
| mode_8 | mode_0 | mode_7 |
+--------+--------+--------+
|      0 |      0 |     52 |
+--------+--------+--------+
-- 2020-01-01 is Wednesday, the first Sunday of the year is 2020-01-05, so it belongs to week 0
SELECT WEEK('2020-01-01') AS week_result;
+-------------+
| week_result |
+-------------+
|           0 |
+-------------+

-- 2020-07-01 is Wednesday, its week contains ≥4 days belonging to 2020, so it's week 27
SELECT WEEK('2020-07-01', 1) AS week_result;
+-------------+
| week_result |
+-------------+
|          27 |
+-------------+

-- Compare mode=0 and mode=3 (differences between different rules)
SELECT 
  WEEK('2023-01-01', 0) AS mode_0, 
  WEEK('2023-01-01', 3) AS mode_3;  
+--------+--------+
| mode_0 | mode_3 |
+--------+--------+
|      1 |     52 |
+--------+--------+

-- -1 & 7 = 7, so mode 7 is used
SELECT WEEK('2023-01-01', -1) AS week_result;
+-------------+
| week_result |
+-------------+
|          52 |
+-------------+

-- Input is DATETIME type (ignores time portion)
SELECT WEEK('2023-12-31 23:59:59', 3) AS week_result;
+-------------+
| week_result |
+-------------+
|          52 |  
+-------------+

-- Any parameter is NULL, result returns NULL
SELECT WEEK('2023-12-31 23:59:59', NULL), WEEK(NULL, 3);
+-----------------------------------+--------------+
| WEEK('2023-12-31 23:59:59', NULL) | WEEK(NULL,3) |
+-----------------------------------+--------------+
|                              NULL |         NULL |
+-----------------------------------+--------------+
Report issue