MINUTE_FLOOR

説明

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

構文

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

パラメータ

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

戻り値

DATETIMEV2 型の値を返し、切り下げられた日時値を表します。

例

SELECT MINUTE_FLOOR("2023-07-13 22:28:18", 5);

+---------------------------------------------------------------+
| minute_floor(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+---------------------------------------------------------------+
| 2023-07-13 22:25:00                                           |
+---------------------------------------------------------------+

注意:

• 期間が指定されていない場合、デフォルトで1分間隔になります。
• 期間は正の整数である必要があります。
• 結果は常に過去の時刻に切り下げられます。
• MINUTE_CEILとは異なり、MINUTE_FLOORは常に間隔を超える部分を切り捨てます。

ベストプラクティス

date_floorも参照してください