ADD_MINUTES スカラー関数

ADD_MINUTES 関数は、最初の引数と指定された分数を足したタイム・スタンプ値を戻します。

構文図を読む構文図をスキップするADD_MINUTES(expression ,numeric-expression)

スキーマは SYSIBM です。

expression
開始タイム・スタンプを指定する式。式は TIMESTAMP、CHAR、 または VARCHAR データ・タイプの値を戻す必要があります。Unicode データベースでは、 式は GRAPHIC または VARGRAPHIC のデータ・タイプにすることもできます。CHAR、VARCHAR、GRAPHIC、および VARGRAPHIC は、暗黙的キャストを介してサポートされます。 式は、DATE の値を戻してはなりません (SQLSTATE 42815)。 expression が CHAR、VARCHAR、GRAPHIC、または VARGRAPHIC のデータ・タイプである場合は、TIMESTAMP スカラー関数で使用できる有効なストリングでなければなりません。
numeric-expression
expression で指定した開始タイム・スタンプに加算する分数を指定する式。 式は組み込み数値、CHAR、または VARCHAR データ・タイプの値を戻す必要があります。 Unicode データベースでは、 式は GRAPHIC または VARGRAPHIC のデータ・タイプにすることもできます。CHAR、VARCHAR、GRAPHIC、および VARGRAPHIC は、暗黙的キャストを介してサポートされます。 BIGINT でない式は、関数の評価の前に BIGINT にキャストされます。 負の数値を使用することで、分数を減算することができます。

この関数の結果は、expression がタイム・スタンプの場合は expression と同じ精度のタイム・スタンプになります。 そうでない場合には、結果は TIMESTAMP(12) になります。 引数のいずれかが NULL になる可能性がある場合、結果も NULL になる可能性があります。 引数のいずれかが NULL の場合、その結果は NULL 値です。

例

  1. 現行タイム・スタンプが 2007 年 1 月 31 日 01:02:03.123456 であるとします。 ホスト変数 ADD_MINUTE に、現行タイム・スタンプに 1 分を足した値を設定します。 
       SET :ADD_MINUTE = ADD_MINUTES(CURRENT TIMESTAMP, 1)
    ホスト変数 ADD_MINUTE には、 2007-01-31-01.03.03.123456 を表す値が設定されます。
  2. TIMESTAMP が 1965 年 7 月 27 日 23:58:59 の値のホスト変数であるとします。 ホスト変数 ADD_MINUTE に、このタイム・スタンプに 3 分を足した値を設定します。 
       SET :ADD_MINUTE = ADD_MINUTES(:TIMESTAMP,3)
    ホスト変数 ADD_MINUTE には、このタイム・スタンプに 3 分を足した 1965-07-28-00.01.59 を表す値が設定されます。
  3. ADD_MINUTES 関数と日時算術計算のどちらを使用しても、同じ結果になります。 以下の例でこれを示します。 
       SET :TIMESTAMPHV = TIMESTAMP '2008-2-28-23.58.59' + 4 MINUTES
   SET :TIMESTAMPHV = ADD_MINUTES( TIMESTAMP '2008-2-28-23.58.59', 4)
    どちらの場合も、ホスト変数 TIMESTAMPHV には値 '2008-02-29-00.02.59' が設定されます。
    今度は、同じ例で 1442 分を加算します。 
       SET :TIMESTAMPHV = TIMESTAMP '2008-2-28-23.58.59' + 1442 MINUTES
   SET :TIMESTAMPHV = ADD_MINUTES(TIMESTAMP '2008-2-28-23.58.59', 1442)
    どちらの場合も、ホスト変数 TIMESTAMPHV には値 '2008-03-01-00.00.59' が設定されます。
  4. TIMESTAMP が 1965 年 7 月 27 日 23:58:59 の値のホスト変数であるとします。 ホスト変数 ADD_MINUTE に、このタイム・スタンプから 3 分を引いた値を設定します。 
       SET :ADD_MINUTE = ADD_MINUTES(:TIMESTAMP,-3)
    ホスト変数 ADD_MINUTE には、1965 年 7 月 27 日 1965 23:58:59 から 3 分を引いた 1965-07-27-23.55.59 を表す値が設定されます。