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