WEEK_CEIL

説明

week_ceil関数は、入力されたdatetime値を指定された週間隔の開始時刻に切り上げます。originが指定されている場合はそれを基準として使用し、そうでなければデフォルトで0000-01-01 00:00:00を使用します。

日付計算式： $$ \begin{aligned} &\text{week_ceil}(\langle\text{date_or_time_expr}\rangle, \langle\text{period}\rangle, \langle\text{origin}\rangle) = \ &\min{\langle\text{origin}\rangle + k \times \langle\text{period}\rangle \times \text{week} \mid \ &k \in \mathbb{Z} \land \langle\text{origin}\rangle + k \times \langle\text{period}\rangle \times \text{week} \geq \langle\text{date_or_time_expr}\rangle} \end{aligned} $$ $k$は、基準時刻から対象時刻に到達するために必要な期間数を表します。

構文

WEEK_CEIL(`<date_or_time_expr>`)
WEEK_CEIL(`<date_or_time_expr>`, `<origin>`)
WEEK_CEIL(`<date_or_time_expr>`, `<period>`)
WEEK_CEIL(`<date_or_time_expr>`, `<period>`, `<origin>`)

パラメータ

Parameter	デスクリプション
<date_or_time_expr>	切り上げる日時値。date/datetime型をサポートします。datetimeおよびdate形式については、datetime conversionおよびdate conversionを参照してください
<period>	週間隔値。INT型で、各間隔の週数を表します
<origin>	間隔の開始点。date/datetime型をサポートします。デフォルトは0000-01-01 00:00:00です

戻り値

DATETIME型を返します。切り上げられた日時値を表します。

• <period>が非正の整数（≤0）の場合、関数はエラーを返します
• いずれかのパラメータがNULLの場合、NULLを返します
• <datetime>が間隔の開始点（<period>と<origin>に基づく）と正確に一致する場合、その開始点を返します
• 入力がdate型の場合、date型を返します
• 入力がdatetime型の場合、元の時刻と同じ時刻部分を持つdatetime型を返します
• 計算結果が最大日時9999-12-31 23:59:59を超える場合、エラーを返します
• <origin>の日時が<period>より後の場合でも、上記の式に従って計算されますが、期間kは負の値になります
• date_or_time_exprにスケールがある場合、返される結果にもスケールが含まれ、小数部分はゼロになります

Examples

-- 2023-07-13 is Thursday, rounds up to next interval start (1-week interval starts on Monday, so rounds to 2023-07-17 (Monday))
SELECT WEEK_CEIL(cast('2023-07-13 22:28:18' as datetime)) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-17 00:00:00 |
+---------------------+

-- Specify 2-week interval
SELECT WEEK_CEIL('2023-07-13 22:28:18', 2) AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-24 00:00:00 |
+---------------------+

-- Input date type returns date type, date string returns datetime
SELECT WEEK_CEIL(cast('2023-07-13' as date));
+---------------------------------------+
| WEEK_CEIL(cast('2023-07-13' as date)) |
+---------------------------------------+
| 2023-07-17                            |
+---------------------------------------+

--input with decimal part 
mysql> SELECT WEEK_CEIL('2023-07-13 22:28:18.123', 2) AS result;
+-------------------------+
| result                  |
+-------------------------+
| 2023-07-24 00:00:00.000 |
+-------------------------+

-- Only with origin date and specified date
select week_ceil("2023-07-13 22:28:18", "2021-05-01 12:00:00");
+---------------------------------------------------------+
| week_ceil("2023-07-13 22:28:18", "2021-05-01 12:00:00") |
+---------------------------------------------------------+
| 2023-07-15 12:00:00                                     |
+---------------------------------------------------------+

-- Specify origin date
SELECT WEEK_CEIL('2023-07-13', 1, '2023-07-03') AS result;
+---------------------+
| result              |
+---------------------+
| 2023-07-17 00:00:00 |
+---------------------+

-- Invalid period (non-positive integer)
SELECT WEEK_CEIL('2023-07-13', 0) AS result;
ERROR 1105 (HY000): errCode = 2, detailMessage = (10.16.10.3)[E-218]Operation week_ceil of 2023-07-13 00:00:00, 0 out of range

-- Parameter is NULL
SELECT WEEK_CEIL(NULL, 1) AS result;
+--------+
| result |
+--------+
| NULL   |
+--------+