PERIOD_DIFF

説明

2つの期間の間の月数の差を計算します。

ここで<period>は整数で、最後の2桁が月（01-12）を表し、前の桁が年を表します。 この関数はperiod_1 - period_2の絶対結果を返します。

年の部分が100未満の場合、特定のルールに従って4桁の年形式に変換されます。

この関数はMySQLのPERIOD_DIFF functionと一貫した動作をします。

構文

PERIOD_DIFF(`<period_1>`, `<period_2>`)

パラメータ

パラメータ	説明
<period_1>	年と月で構成される期間を表します。 フォーマット: 月は末尾2桁を占め、[1, 12]の範囲内である必要があります。前の桁は年を表し、年の桁数に制限はありません。4桁を超えることも可能です。 年の推定: 年の値は末尾2桁を除くすべての桁から直接取得されます。年が2桁の数値（範囲：[00, 99]）の場合、年が70未満であれば20YYと解釈され、70以上であれば19YYと解釈されます。 値の範囲: [0, 2^63-1]の範囲内の整数パラメータを受け入れます。
<period_2>	別の期間を表します。フォーマット要件は<period_1>と同じです。

戻り値

<period_1>の総月数から<period_2>の総月数を引いた値を表す整数を返します。

いずれかのパラメータがNULLの場合、または値がBIGINTに変換できない場合、関数はNULLを返します。

パラメータが負の値である場合、または月の部分が無効な場合、関数はエラーをスローします。

例

SELECT `period_1`, `period_2`, PERIOD_DIFF(`period_1`, `period_2`) AS DIFF FROM `test_period_diff`;

+---------------------+----------+---------------------+
| period_1            | period_2 | DIFF                |
+---------------------+----------+---------------------+
| 200802              |   200703 |                  11 |
| 200703              |   200802 |                 -11 |
| 7001                |     6912 |               -1199 |
| NULL                |     2510 |                NULL |
| 2510                |     NULL |                NULL |
| 9223372036854775807 |      101 | 1106804644422549090 |
| 9223372036854775808 |      101 |                NULL |
+---------------------+----------+---------------------+

最後の行では、period_1がBIGINTの上限値（2^63-1）を超えているため、出力はNULLになります。

SELECT PERIOD_DIFF(1, -1);
-- ERROR 1105 (HY000): errCode = 2, detailMessage = (127.0.0.1)[INVALID_ARGUMENT]Period function got invalid period: -1