TIMESTAMPTZ_CMP_TIMESTAMP 関数 - Amazon Redshift
構文引数戻り型例

Amazon Redshift は、パッチ 198 以降、新しい Python UDF の作成をサポートしなくなります。既存の Python UDF は、2026 年 6 月 30 日まで引き続き機能します。詳細については、ブログ記事を参照してください。

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