

 从补丁 198 开始，Amazon Redshift 将不再支持创建新的 Python UDF。现有的 Python UDF 将继续正常运行至 2026 年 6 月 30 日。有关更多信息，请参阅[博客文章](https://www.amazonaws.cn/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)。

# TIMESTAMPTZ\$1CMP\$1DATE 函数
<a name="r_TIMESTAMPTZ_CMP_DATE"></a>

TIMESTAMPTZ\$1CMP\$1DATE 将时间戳和日期的值进行比较。如果时间戳和日期值相同，则此函数返回 `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)
```