DATEAmazon の _DIFF 関数 QLDB - Amazon Quantum 台帳データベース (Amazon QLDB）
構文引数戻り型例関連関数

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

DATEAmazon の _DIFF 関数 QLDB

重要

サポート終了通知: 既存のお客様は、07/31/2025 のサポート終了QLDBまで Amazon を使用できます。詳細については、「Amazon Ledger QLDB を Amazon Aurora Postgre に移行するSQL」を参照してください。

Amazon ではQLDB、 DATE_DIFF関数を使用して、指定された 2 つのタイムスタンプの指定された日付部分の差を返します。

構文

DATE_DIFF( datetimepart, timestamp1, timestamp2 )

引数

datetimepart

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

  • year

  • month

  • day

  • hour

  • minute

  • second

timestamp1, timestamp2

関数が比較する 2 つのフィールド名または timestamp データ型の式。If timestamp2 は より後です timestamp1の場合、結果は陽性です。If timestamp2 は より前です timestamp1の場合、結果は負です。

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

戻り型

int

例

DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010-12T`, `2011-01T`)                  -- 0 (must be at least 12 months apart to evaluate as a 1 year difference)
DATE_DIFF(month, `2010T`, `2010-05T`)                    -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(month, `2010-12-31T`, `2011-01-01T`)           -- 0 (must be at least a full month apart to evaluate as a 1 month difference)
DATE_DIFF(day, `2010-01-01T23:00Z`, `2010-01-02T01:00Z`) -- 0 (must be at least 24 hours apart to evaluate as a 1 day difference)

-- Runnable statements
SELECT DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`) FROM << 0 >> -- 1
SELECT DATE_DIFF(month, `2010T`, `2010-05T`) FROM << 0 >>         -- 4

関連関数