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

MINUTE_CEIL

説明​

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

構文​

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

パラメータ​

Parameterデスクリプション
<datetime>切り上げる日時値。DATETIME型またはDATETIMEV2型
<period>分間隔値。INT型で、各間隔の分数を表す
<origin>間隔の開始点。DATETIME型またはDATETIMEV2型。デフォルトは0001-01-01 00:00:00

Return Value​

指定された分間隔に基づいて切り上げられた日時値を表すDATETIMEV2型の値を返します。戻り値の精度は入力パラメータdatetimeの精度と同じです。

Example​

SELECT MINUTE_CEIL("2023-07-13 22:28:18", 5);
+--------------------------------------------------------------+
| minute_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+--------------------------------------------------------------+
| 2023-07-13 22:30:00                                          |
+--------------------------------------------------------------+

注意:

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

ベストプラクティス​

date_ceilも参照してください