

 从补丁 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/)。

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

DATE\$1CMP\$1TIMESTAMPTZ 将日期与带有时区的时间戳进行比较，并在值相同时返回 `0`，*date* 按时间顺序较大时返回 `1`，*timestamptz* 较大时返回 `-1`。

## 语法
<a name="r_DATE_CMP_TIMESTAMPTZ-syntax"></a>

```
DATE_CMP_TIMESTAMPTZ(date, timestamptz)
```

## 参数
<a name="r_DATE_CMP_TIMESTAMPTZ-arguments"></a>

 *date*   
数据类型为 `DATE` 的列，或一个隐式计算结果为 `DATE` 类型的表达式。

 *timestamptz*   
数据类型为 `TIMESTAMPTZ` 的列，或一个隐式计算结果为 `TIMESTAMPTZ` 类型的表达式。

## 返回类型
<a name="r_DATE_CMP_TIMESTAMPTZ-return-type"></a>

INTEGER

## 示例
<a name="r_DATE_CMP_TIMESTAMPTZ-examples"></a>

以下示例将日期 `2008-06-18` 与 LISTTIME 进行比较。在此日期之前创建的清单返回 `1`；此日期之后创建的清单返回 `-1`。

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

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