MariaDBでのPERIOD_ADD（）のしくみ

MariaDBでは、PERIOD_ADD() は、特定の月数を期間に追加する組み込みの日付と時刻の関数です。

戻り値はYYYYMMの形式です。

構文

構文は次のようになります：

PERIOD_ADD(P,N)

ここでP は期間であり、N 追加する月数です。

P YYMMまたはYYYYMMの形式であり、日付値ではありません。

例

次に例を示します：

SELECT PERIOD_ADD(202011, 1);

結果：

+-----------------------+
| PERIOD_ADD(202011, 1) |
+-----------------------+
|                202012 |
+-----------------------+

その例では、期間に1か月が追加されました。

期間に6か月を追加するものは次のとおりです。

SELECT PERIOD_ADD(202011, 6);

結果：

+-----------------------+
| PERIOD_ADD(202011, 6) |
+-----------------------+
|                202105 |
+-----------------------+

2桁の年

最初の引数に2桁の年が含まれている場合、00から69までの値は2000から2069に変換され、70からの値は1970以上に変換されます。

例：

SELECT 
    PERIOD_ADD(6910, 2),
    PERIOD_ADD(7010, 2);

結果：

+---------------------+---------------------+
| PERIOD_ADD(6910, 2) | PERIOD_ADD(7010, 2) |
+---------------------+---------------------+
|              206912 |              197012 |
+---------------------+---------------------+

最初の年は2069年に戻り、2番目の年は1970年に戻りました。

引数がありません

PERIOD_ADD()を呼び出す引数の数が間違っているか、引数を渡さないと、エラーが発生します：

SELECT PERIOD_ADD();

結果：

ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'

そして別の例：

SELECT PERIOD_ADD( 2010 );

結果：

ERROR 1582 (42000): Incorrect parameter count in the call to native function 'PERIOD_ADD'