メインコンテンツまでスキップ
バージョン: 4.x

WEEK_FLOOR

デスクリプション

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

Syntax

WEEK_FLOOR(<datetime>)
WEEK_FLOOR(<datetime>, <origin>)
WEEK_FLOOR(<datetime>, <period>)
WEEK_FLOOR(<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_FLOOR('2023-07-13 22:28:18', 2);
+------------------------------------------------------------+
| week_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 2) |
+------------------------------------------------------------+
| 2023-07-03 00:00:00 |
+------------------------------------------------------------+