WEEK_CEIL
デスクリプション
datetime値を指定された週間隔の最も近い値に切り上げます。開始時刻（origin）が提供された場合、その時刻を間隔計算の基準として使用します。
Syntax
WEEK_CEIL(<datetime>)
WEEK_CEIL(<datetime>, <origin>)
WEEK_CEIL(<datetime>, <period>)
WEEK_CEIL(<datetime>, <period>, <origin>)
パラメータ
| Parameter | デスクリプション |
|---|---|
<datetime> | 切り上げを行う日時値。型は DATETIME または DATETIMEV2 |
<period> | 週間隔値。型は INT で、各間隔の週数を表す |
<origin> | 間隔の開始点。型は DATETIME または DATETIMEV2。デフォルトは 0001-01-01 00:00:00 |
Return Value
DATETIME 型の値を返します。これは切り上げされた日時値を表します。結果の時刻部分は 00:00:00 に設定されます。
Note:
- period が指定されない場合、デフォルトで1週間間隔になります。
- period は正の整数である必要があります。
- 結果は常に将来の時刻に切り上げられます。
- 返される値の時刻部分は常に 00:00:00 に設定されます。
Example
SELECT WEEK_CEIL('2023-07-13 22:28:18', 2);
+-----------------------------------------------------------+
| week_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 2) |
+-----------------------------------------------------------+
| 2023-07-17 00:00:00 |
+-----------------------------------------------------------+