TIMESTAMP_CMP_TIMESTAMPTZ 関数

TIMESTAMP_CMP_TIMESTAMPTZ は、タイムスタンプ式の値と、タイムゾーン式を含むタイムスタンプを比較します。タイムスタンプと、タイムゾーン付きのタイムスタンプの値が同じである場合、関数は 0 を返します。タイムスタンプが時間的により大きい場合、関数は 1 を返します。タイムゾーン付きのタイムスタンプがより大きい場合、関数は –1 を返します。

構文

TIMESTAMP_CMP_TIMESTAMPTZ(timestamp, timestamptz)

引数

timestamp

データ型 TIMESTAMP の列または TIMESTAMP 型に暗黙的に評価される式。

timestamptz

データ型 TIMESTAMPTZ の列または TIMESTAMPTZ 型に暗黙的に評価される式。

戻り型

INTEGER

例

次の例では、タイムスタンプと、タイムゾーン付のタイムスタンプを比較し、比較の結果を示します。

SELECT TIMESTAMP_CMP_TIMESTAMPTZ('2008-01-24 06:43:29', '2008-01-24 06:43:29+00'), TIMESTAMP_CMP_TIMESTAMPTZ('2008-01-24 06:43:29', '2008-02-18 02:36:48+00'), TIMESTAMP_CMP_TIMESTAMPTZ('2008-02-18 02:36:48', '2008-01-24 06:43:29+00');

timestamp_cmp_timestamptz  | timestamp_cmp_timestamptz | timestamp_cmp_timestamptz 
---------------------------+---------------------------+--------------------------
             0             |            -1             |             1