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

MONTHS_ADD

説明​

MONTHS_ADD関数は、指定された日付に指定された月数を加算または減算し、結果の日付を返すために使用されます。

構文​

MONTHS_ADD(<datetime/date>, <nums>)

パラメータ​

Parameterデスクリプション
<datetime/date>月が加算または減算される日付値
<nums>加算または減算する月数

Return Value​

戻り値は入力の<datetime/date>と同じ型になります。 特殊なケース：

  • <datetime/date>入力が0000-00-00または0000-00-00 00:00:00の場合、関数はNULLを返します。
  • <datetime/date>入力がNULLの場合、関数はNULLを返します。
  • 入力がMONTHS_ADD("9999-12-31", 1)の場合、関数はNULLを返します。

Example​

select months_add("2020-01-31 02:02:02", 1),months_add("2020-01-31", 1),months_add("2020-01-31", -1);
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+
| months_add(cast('2020-01-31 02:02:02' as DATETIMEV2(0)), 1) | months_add(cast('2020-01-31' as DATEV2), 1) | months_add(cast('2020-01-31' as DATEV2), -1) |
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+
| 2020-02-29 02:02:02                                         | 2020-02-29                                  | 2019-12-31                                   |
+-------------------------------------------------------------+---------------------------------------------+----------------------------------------------+