WEEK_FLOOR

説明

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

構文

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

Parameters

Parameter	Description
<datetime>	切り下げる日時値。DATETIME型またはDATETIMEV2型
<period>	週間隔値。INT型で、各間隔の週数を表す
<origin>	間隔の開始点。DATETIME型またはDATETIMEV2型。デフォルトは0001-01-01 00:00:00

Return Value

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

注意:

• 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                                        |
+------------------------------------------------------------+