DATEADD

Synopsis

DATEADD(datepart,integer-exp,date-exp)

概要

DATEADD 関数は、指定された日付部分を指定された単位数でインクリメントすることで、日付/時刻式を変更します。例えば、datepart が 'month' で、integer-exp が 5 の場合は、DATEADD は date-exp に 5 か月をインクリメントします。また、integer-exp に負の整数を指定して、日付部分をデクリメントすることもできます。

計算された日付は、完全な日付/時刻式 (タイムスタンプ) として返されます。DATEADD はデータ型 %Library.TimeStampOpens in a new tab (yyyy-mm-dd hh:mm:ss.fff) を返します。

DATEADD は、各月の日数やうるう年を考慮に入れて、常に有効な日付を返します。例えば、1 月 31 日に 1 か月をインクリメントすると 2 月 28 日 (該当月の有効な最終日付) が返されますが、指定された年がうるう年の場合は 2 月 29 日が返されます。うるう年の 2 月 29 日に 1 年をインクリメントすると 2 月 28 日が返されます。うるう年の 2 月 29 日に 4 年をインクリメントすると 2 月 29 日が返されます。

秒の小数部を含む date-exp を指定した場合は、返り値にも秒の小数部が含まれます。date-exp の時刻部分を省略した場合、DATEADD は既定時刻の 00:00:00 を返します。date-exp の日付部分を省略した場合、DATEADD は既定日付の 1900–01–01 を返します。

DATEADD と TIMESTAMPADD では四半期 (3 か月の間隔) が処理されます。DATEDIFF と TIMESTAMPDIFF では四半期は処理されません。

同様の日付/時刻変更の演算は、TIMESTAMPADD ODBC スカラ関数を使用して実行できます。

この関数は、ObjectScript から DATEADD()Opens in a new tab メソッド呼び出しを使用して呼び出すこともできます。

$SYSTEM.SQL.DATEADD(datepart,integer-exp,date-exp)

mmdelimiterdddelimiter[yy]yy
dd Mmm[mm][,][yy]yy
dd [yy]yy Mmm[mm]
yyyy Mmm[mm] dd
yyyy [dd] Mmm[mm]

HH:MM[:SS:SSS][{AM|PM}]
HH:MM[:SS.S]
HH['']{AM|PM}

例

以下の例は、指定された日付に 1 週を加算します。

SELECT DATEADD('week',1,'1999-12-20') AS NewDate

1 週の加算は 7 日の加算になるので、上記の例は 1999-12-27 00:00:00 を返します。この DATEADD では、時刻部分が省略されています。

以下の例は、元のタイムスタンプに 5 か月を加算します。

SELECT DATEADD(MM,5,'1999-12-20 12:00:00') AS NewDate

5 か月を加算すると年がインクリメントされるので、上記の例は 2000-05-20 12:00:00 を返します。

以下の例も、元のタイムスタンプに 5 か月を加算します。

SELECT DATEADD('mm',5,'1999-01-31 12:00:00') AS NewDate

上記の例は 1999-06-30 12:00:00 を返します。この DATEADD は、月だけでなく日の値も変更します。これは単純に月をインクリメントすると、無効な日付の 6 月 31 日となるためです。

以下の例は、元のタイムスタンプに 45 分を加算します。

SELECT DATEADD(MI,45,'1999-12-20 12:00:00') AS NewTime

上記の例は 1999-12-20 12:45:00 を返します。

以下の例も、元のタイムスタンプに 45 分を加算しますが、この場合は日付もインクリメントされます。

SELECT DATEADD('mi',45,'1999-12-20 23:30:00') AS NewTime

上記の例は 1999-12-21 00:15:00 を返します。

以下の例は、元のタイムスタンプに 45 分をデクリメントします。

SELECT DATEADD(N,-45,'1999-12-20 12:00:00') AS NewTime

上記の例は 1999-12-20 11:15:00 を返します。

以下の例は、現在の日付に 60 日を加算し、結果を各月の長さに合わせて調整します。

SELECT DATEADD(D,60,CURRENT_DATE) AS NewDate

以下の例では、最初の DATEADD は指定日付に 92 日を、2 つ目の DATEADD は指定日付に 3 カ月を加えます。

SELECT DATEADD('dd',92,'1999-12-20') AS NewDateD,
       DATEADD('qq',1,'1999-12-20') AS NewDateQ

最初の例は 2000-03-21 00:00:00 を返し、2 番目の例は 2000-03-20 00:00:00 を返します。1 四半期をインクリメントすると、月部分に 3 がインクリメントされ、必要に応じて年部分がインクリメントされます。また、結果月の最大日数に合わせて修正されます。

上記の例は、すべて datepart に省略形を使用しています。しかし、datepart には、以下の例のように正式な名前を指定することもできます。

SELECT DATEADD('day',92,'1999-12-20') AS NewDate

上記の例は 2000-03-21 00:00:00 を返します。

以下の埋め込み SQL の例では、ホスト変数を使用して前述の例と同じ DATEADD 処理を実行しています。

  SET x="day"
  SET datein="1999-12-20"
  &sql(SELECT DATEADD(:x,92,:datein)
       INTO :dateout)
  WRITE "in:  ",datein,!,"out: ",dateout

関連項目

• DATEDIFF 関数

• DATENAME 関数

• DATEPART 関数

• TIMESTAMPADD 関数

• TIMESTAMPDIFF 関数