Amazon QLDB の DATE_ADD 関数

Amazon QLDB では、特定のタイムスタンプ値を指定された間隔でインクリメントするには、DATE_ADD 関数を使用します。

構文

DATE_ADD( datetimepart, interval, timestamp )

引数

日付/時刻部分

関数が動作する日付または時刻の部分。このパラメーターは、次のいずれかになります。

• year

• month

• day

• hour

• minute

• second

interval

指定されたタイムスタンプに追加する間隔を指定する整数。負の整数は間隔を減算します。

timestamp

関数によってインクリメントされるフィールド名または timestamp データ型の式。

Ion タイムスタンプリテラル値はバックティック (`...`) で示すことができます。フォーマットの詳細とタイムスタンプ値の例については、Amazon Ion 仕様書の「タイムスタンプ」を参照してください。

戻り型

timestamp

例

DATE_ADD(year, 5, `2010-01-01T`)                -- 2015-01-01T
DATE_ADD(month, 1, `2010T`)                     -- 2010-02T (result adds precision as necessary)
DATE_ADD(month, 13, `2010T`)                    -- 2011-02T (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_ADD(day, -1, `2017-01-10T`)                -- 2017-01-09T
DATE_ADD(hour, 1, `2017T`)                      -- 2017-01-01T01:00Z
DATE_ADD(hour, 1, `2017-01-02T03:04Z`)          -- 2017-01-02T04:04Z
DATE_ADD(minute, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:05:05.006Z
DATE_ADD(second, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:04:06.006Z

-- Runnable statements
SELECT DATE_ADD(year, 5, `2010-01-01T`) FROM << 0 >> -- 2015-01-01T
SELECT DATE_ADD(day, -1, `2017-01-10T`) FROM << 0 >> -- 2017-01-09T

関連関数

• DATE_DIFF

• EXTRACT

• TO_STRING

• TO_TIMESTAMP

• UTCNOW