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