MINUTES_BETWEEN スカラー関数
MINUTES_BETWEEN 関数は、指定された引数の間の分数を戻します。
スキーマは SYSIBM です。
- expression1
- 2 つの日時値の間の分数を計算するために使用する、1 つ目の日時値を指定する式。 式は DATE、TIMESTAMP、CHAR、 または VARCHAR データ・タイプの値を戻す必要があります。 Unicode データベースでは、 式は GRAPHIC または VARGRAPHIC のデータ・タイプにすることもできます。CHAR、VARCHAR、GRAPHIC、および VARGRAPHIC は、暗黙的キャストを介してサポートされます。expression1 が CHAR、VARCHAR、GRAPHIC、または VARGRAPHIC のデータ・タイプである場合は、TIMESTAMP スカラー関数で使用できる有効なストリングでなければなりません。
- expression2
- 2 つの日時値の間の分数を計算するために使用する、2 つ目の日時値を指定する式。 式は DATE、TIMESTAMP、CHAR、 または VARCHAR データ・タイプの値を戻す必要があります。 Unicode データベースでは、 式は GRAPHIC または VARGRAPHIC のデータ・タイプにすることもできます。CHAR、VARCHAR、GRAPHIC、および VARGRAPHIC は、暗黙的キャストを介してサポートされます。expression2 が CHAR、VARCHAR、GRAPHIC、または VARGRAPHIC のデータ・タイプである場合は、TIMESTAMP スカラー関数で使用できる有効なストリングでなければなりません。
expression1 と expression2 の間が 1 分に満たない場合、結果はゼロになります。 expression1 が expression2 より後である場合、結果は正になります。 expression1 が expression2 より前である場合、結果は負になります。 expression1 または expression2 に時刻情報が含まれている場合は、その情報も分数の計算に使用されます。 expression1 または expression2 に時刻情報が含まれていない場合は、時刻情報が欠落している引数の時刻として午前 0 時 (00.00.00) が使用されます。
関数の結果は BIGINT です。引数のいずれかが NULL になる可能性がある場合、結果も NULL になる可能性があります。引数が NULL の場合、結果は NULL 値になります。
例
- ホスト変数 NUM_MINUTES に、2012-03-01-01.00.00 と 2012-02-28-00.00.00 の間の分数を設定します。
ホスト変数 NUM_MINUTES は 2940 に設定されます。この分数のうちの 1440 は、2012 年 2 月 29 日の分です。SET :NUM_MINUTES = MINUTES_BETWEEN(TIMESTAMP '2012-03-01-01.07.00', TIMESTAMP '2012-02-28-00.00.00') - ホスト変数 NUM_MINUTES に、2013-09-11-23.59.59 と 2013-09-01-00.00.00 の間の分数を設定します。
引数の間は 15840 分に 1 秒足りないため、ホスト変数 NUM_MINUTES は 15839 に設定されます。 結果が正になるのは、1 つ目の引数のほうが 2 つ目の引数より後の時間だからです。SET :NUM_MINUTES = MINUTES_BETWEEN(TIMESTAMP '2013-09-11-23.59.59', TIMESTAMP '2013-09-01-00.00.00') - ホスト変数 NUM_MINUTES に、2013-09-01-00.00.00 と 2013-09-11-23.59.59 の間の分数を設定します。
引数の間は 15840 分に 1 秒足りないため、ホスト変数 NUM_MINUTES は -15839 に設定されます。 結果が負になるのは、1 つ目の引数のほうが 2 つ目の引数より前の時間だからです。SET :NUM_MINUTES = MINUTES_BETWEEN(TIMESTAMP '2013-09-01-00.00.00', TIMESTAMP '2013-09-11-23.59.59')