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

Amazon Redshift は、2025 年 11 月 1 日以降、新しい Python UDF の作成をサポートしなくなります。Python UDF を使用する場合は、その日付より前に UDF を作成してください。既存の Python UDF は引き続き通常どおり機能します。詳細については、ブログ記事を参照してください。

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