dateadd()

日付に指定した単位だけ加算または減算して新しい日付を返します。

構文

パラメーター

DATE

基準日付を返す式です。

UNIT

加算または減算する時間単位を表す文字列です。サポートする単位は次のとおりです。

DELTA

DATEに加算または減算する整数値です。正の値の場合は加算し、負の値の場合は減算します。

説明

dateadd() 関数は、DATEに指定した単位（UNIT）だけDELTAを加算または減算して日付を返します。返却型はtimestampです。

DATEがnullまたは日付型でない場合はnullを返します。UNITが有効でない場合はnullを返します。DELTAが整数でない場合はnullを返します。

エラーコード

90620

引数の数が3個でない場合に発生します。

90621

UNIT値が有効でない場合に発生します。fieldパラメーターに不正な単位が含まれます。

90622

DELTAが整数型でない定数の場合に発生します。timeパラメーターに該当する値が含まれます。

使用例

これらの使用例で参照するWEB_APACHE_SAMPLEテーブルを準備するには、クエリ実習用データを参照してください。

1. アクセスログの時刻に1日を加算する

   table limit=5 WEB_APACHE_SAMPLE | eval result = dateadd(_time, "day", 1)
   | fields _time, result
   

2. アクセスログの時刻から3時間を減算する

   table limit=5 WEB_APACHE_SAMPLE | eval result = dateadd(_time, "hour", -3)
   | fields _time, result
   

3. null入力

   json "{}" | eval result = dateadd(null, "hour", 1)
   | # result: null
   

互換性

dateadd() 関数はSonar 4.0以前のバージョンから提供されています。