メインコンテンツまでスキップ

WEEK_CEIL

説明

日時値を指定された週間隔の最も近い値に切り上げます。開始時刻(基準点)が提供された場合、その時刻を間隔を計算するための基準として使用します。

構文

WEEK_CEIL(<datetime>)
WEEK_CEIL(<datetime>, <origin>)
WEEK_CEIL(<datetime>, <period>)
WEEK_CEIL(<datetime>, <period>, <origin>)

パラメータ

パラメータ説明
<datetime>切り上げる日時値、DATETIME または DATETIMEV2 型
<period>週間隔値、INT 型、各間隔の週数を表す
<origin>間隔の開始点、DATETIME または DATETIMEV2 型;デフォルトは 0001-01-01 00:00:00

戻り値

DATETIME 型の値を返し、切り上げられた日時値を表します。結果の時刻部分は 00:00:00 に設定されます。

注意:

  • period が指定されていない場合、デフォルトで 1 週間間隔になります。
  • period は正の整数である必要があります。
  • 結果は常に将来の時刻に切り上げられます。
  • 返される値の時刻部分は常に 00:00:00 に設定されます。

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-24 00:00:00 |
+-----------------------------------------------------------+