TIMESTAMPTZ_CMP_TIMESTAMP 関数
TIMESTAMPTZ_CMP_TIMESTAMP は、タイムゾーン式を含むタイムスタンプの値とタイムスタンプ式を比較します。タイムゾーン付きのタイムスタンプと、タイムスタンプ値が同じである場合、関数は 0
を返します。タイムゾーン付きのタイムスタンプが時間的に大きい場合、関数は 1
を返します。タイムスタンプがより大きい場合、関数は –1
を返します。
構文
TIMESTAMPTZ_CMP_TIMESTAMP(timestamptz, timestamp)
引数
- timestamptz
-
データ型
TIMESTAMPTZ
の列またはTIMESTAMPTZ
型に暗黙的に評価される式。 - timestamp
-
データ型
TIMESTAMP
の列またはTIMESTAMP
型に暗黙的に評価される式。
戻り型
INTEGER
例
次の例では、タイムゾーン付きタイムスタンプとタイムスタンプを比較し、比較の結果を示しています。
SELECT TIMESTAMPTZ_CMP_TIMESTAMP('2008-01-24 06:43:29+00', '2008-01-24 06:43:29'), TIMESTAMPTZ_CMP_TIMESTAMP('2008-01-24 06:43:29+00', '2008-02-18 02:36:48'), TIMESTAMPTZ_CMP_TIMESTAMP('2008-02-18 02:36:48+00', '2008-01-24 06:43:29');
timestamptz_cmp_timestamp | timestamptz_cmp_timestamp | timestamptz_cmp_timestamp ---------------------------+---------------------------+--------------------------- 0 | -1 | 1