ADD_DAYS スカラー関数

ADD_DAYS 関数は、最初の引数に指定日数を足した日時値を戻します。

スキーマは SYSIBM です。

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

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

例

今日が 2007 年 1 月 31 日であるとします。ホスト変数 ADD_DAY に、今日に 1 日を足した値を設定します。
```
   SET :ADD_DAY = ADD_DAYS(CURRENT_DATE, 1)
```
ホスト変数 ADD_DAY には、2007-02-01 を表す値が設定されます。
DATE が、1965 年 7 月 27 日の値を設定されたホスト変数であるとします。ホスト変数 ADD_DAY に、この日に 3 日を足した値を設定します。
```
   SET :ADD_DAY = ADD_DAYS(:DATE,3)
```
ホスト変数 ADD_DAY には、この日に 3 日を足した 1965-07-30 を表す値が設定されます。
ADD_DAYS 関数と日時算術計算のどちらを使用しても、同じ結果になります。以下の例でこれを示します。
```
   SET :DATEHV = DATE('2008-2-28') + 4 DAYS
   SET :DATEHV = ADD_DAYS('2008-2-28', 4)
```
どちらの場合も、ホスト変数 DATEHV には値 '2008-03-03' が設定されます。
今度は、同じ例で日付 '2008-2-29' を引数にします。
```
   SET :DATEHV = DATE('2008-2-29') + 4 DAYS
   SET :DATEHV = ADD_DAYS('2008-2-29', 4)
```
どちらの場合も、ホスト変数 DATEHV には値 '2008-03-04' が設定されます。
DATE が、1965 年 7 月 27 日の値を設定されたホスト変数であるとします。ホスト変数 ADD_DAY に、この日付から 3 日を引いた値を設定します。
```
   SET :ADD_DAY = ADD_DAYS(:DATE,-3)
```
ホスト変数 ADD_DAY には、1965 年 7 月 27 日から 3 日を引いた 1965-07-24 を表す値が設定されます。