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

MONTHS_DIFF

説明

MONTHS_DIFF関数は、2つの日付間の完全な月数を計算します。2つの日付引数を受け取り、月単位の差を整数として返します。

構文

MONTHS_DIFF(<enddate>, <startdate>)

パラメータ

パラメータ説明
<enddate>終了日。差分計算における後の日付を表します。DATE(例:YYYY-MM-DD)またはDATETIME(例:YYYY-MM-DD HH:MM:SS)型をサポートします。
<startdate>開始日。差分計算における前の日付を表します。DATE(例:YYYY-MM-DD)またはDATETIME(例:YYYY-MM-DD HH:MM:SS)型をサポートします。

戻り値

<enddate>から<startdate>を引いた結果の月数を返します

  • <enddate>または<startdate>のいずれかがNULLの場合、または両方がNULLの場合、NULLを返します

select months_diff('2020-12-25','2020-10-25'),months_diff('2020-10-25 10:00:00','2020-12-25 11:00:00');
+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------+
| months_diff(cast('2020-12-25' as DATETIMEV2(0)), cast('2020-10-25' as DATETIMEV2(0))) | months_diff(cast('2020-10-25 10:00:00' as DATETIMEV2(0)), cast('2020-12-25 11:00:00' as DATETIMEV2(0))) |
+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------+
| 2 | -2 |
+---------------------------------------------------------------------------------------+---------------------------------------------------------------------------------------------------------+