

 Amazon Redshift 將不再支援從修補程式 198 開始建立新的 Python UDFs。現有 Python UDF 將繼續正常運作至 2026 年 6 月 30 日。如需詳細資訊，請參閱[部落格文章](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# TIMESTAMPTZ\_CMP\_DATE 函數
<a name="r_TIMESTAMPTZ_CMP_DATE"></a>

TIMESTAMPTZ\_CMP\_DATE 會比較時間戳記值和日期的值。如果時間戳記和日期值相同，則函數會傳回 `0`。如果時間戳記依時間順序較大，則函數會傳回 `1`。如果日期較大，則函數會傳回 `–1`。

## 語法
<a name="r_TIMESTAMPTZ_CMP_DATE-syntax"></a>

```
TIMESTAMPTZ_CMP_DATE(timestamptz, date)
```

## 引數
<a name="r_TIMESTAMPTZ_CMP_DATE-arguments"></a>

 *timestamptz*   
`TIMESTAMPTZ` 資料類型的欄，或是隱含評估為 `TIMESTAMPTZ` 類型的運算式。

 *date*   
`DATE` 資料類型的欄，或是隱含評估為 `DATE` 類型的運算式。

## 傳回類型
<a name="r_TIMESTAMPTZ_CMP_DATE-return-type"></a>

INTEGER

## 範例
<a name="r_TIMESTAMPTZ_CMP_DATE-examples"></a>

下列範例會比較做為含時區之時間戳記的 LISTTIME 與日期 `2008-06-18`。在此日期後所做的清單會傳回 `1`，在此日期前所做的清單會傳回 `-1`。

```
select listid, CAST(listtime as timestamptz) as tstz,
timestamp_cmp_date(tstz, '2008-06-18')
from listing
order by 1, 2, 3
limit 10;


 listid |          tstz          | timestamptz_cmp_date
--------+------------------------+----------------------
      1 | 2008-01-24 06:43:29+00 |              -1
      2 | 2008-03-05 12:25:29+00 |              -1
      3 | 2008-11-01 07:35:33+00 |               1
      4 | 2008-05-24 01:18:37+00 |              -1
      5 | 2008-05-17 02:29:11+00 |              -1
      6 | 2008-08-15 02:08:13+00 |               1
      7 | 2008-11-15 09:38:15+00 |               1
      8 | 2008-11-09 05:07:30+00 |               1
      9 | 2008-09-09 08:03:36+00 |               1
     10 | 2008-06-17 09:44:54+00 |              -1
(10 rows)
```