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

MONTH_CEIL

説明​

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

構文​

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

パラメータ​

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

Return Value​

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

Example​

SELECT MONTH_CEIL("2023-07-13 22:28:18", 5);
+-------------------------------------------------------------+
| month_ceil(cast('2023-07-13 22:28:18' as DATETIMEV2(0)), 5) |
+-------------------------------------------------------------+
| 2023-10-01 00:00:00                                         |
+-------------------------------------------------------------+

注意:

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

ベストプラクティス​

date_ceilも参照してください