

 O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função TIMESTAMP\_CMP
<a name="r_TIMESTAMP_CMP"></a>

Compara o valor de dois timestamps e retorna um número inteiro. Se os carimbos de data/hora forem idênticos, a função retornará `0`. Se o primeiro carimbo de data/hora for maior, a função retornará `1`. Se o segundo carimbo de data/hora for maior, a função retornará `-1`.

## Sintaxe
<a name="r_TIMESTAMP_CMP-synopsis"></a>

```
TIMESTAMP_CMP(timestamp1, timestamp2)
```

## Argumentos
<a name="r_TIMESTAMP_CMP-arguments"></a>

 *timestamp1*   
Uma coluna de tipo de dados `TIMESTAMP` ou uma expressão que é avaliada implicitamente como um tipo `TIMESTAMP`.

 *timestamp2*   
Uma coluna de tipo de dados `TIMESTAMP` ou uma expressão que é avaliada implicitamente como um tipo `TIMESTAMP`.

## Tipo de retorno
<a name="r_TIMESTAMP_CMP-return-type"></a>

INTEGER

## Exemplos
<a name="r_TIMESTAMP_CMP-examples"></a>

O exemplo a seguir compara os carimbos de data/hora e mostra os resultados da comparação.

```
SELECT TIMESTAMP_CMP('2008-01-24 06:43:29', '2008-01-24 06:43:29'), TIMESTAMP_CMP('2008-01-24 06:43:29', '2008-02-18 02:36:48'), TIMESTAMP_CMP('2008-02-18 02:36:48', '2008-01-24 06:43:29');

timestamp_cmp  | timestamp_cmp | timestamp_cmp 
---------------+---------------+---------------
             0 |            -1 |             1
```

O seguinte exemplo compara o LISTTIME e SALETIME de uma oferta. Observe que o valor referente a TIMESTAMP\_CMP é de `-1` para todas as listagens, pois o carimbo de data/hora da venda é posterior ao carimbo de data/hora das listagens.

```
select listing.listid, listing.listtime,
sales.saletime, timestamp_cmp(listing.listtime, sales.saletime)
from listing, sales
where listing.listid=sales.listid
order by 1, 2, 3, 4
limit 10;

 listid |      listtime       |      saletime       | timestamp_cmp
--------+---------------------+---------------------+---------------
      1 | 2008-01-24 06:43:29 | 2008-02-18 02:36:48 |            -1
      4 | 2008-05-24 01:18:37 | 2008-06-06 05:00:16 |            -1
      5 | 2008-05-17 02:29:11 | 2008-06-06 08:26:17 |            -1
      5 | 2008-05-17 02:29:11 | 2008-06-09 08:38:52 |            -1
      6 | 2008-08-15 02:08:13 | 2008-08-31 09:17:02 |            -1
     10 | 2008-06-17 09:44:54 | 2008-06-26 12:56:06 |            -1
     10 | 2008-06-17 09:44:54 | 2008-07-10 02:12:36 |            -1
     10 | 2008-06-17 09:44:54 | 2008-07-16 11:59:24 |            -1
     10 | 2008-06-17 09:44:54 | 2008-07-22 02:23:17 |            -1
     12 | 2008-07-25 01:45:49 | 2008-08-04 03:06:36 |            -1
(10 rows)
```

Este exemplo mostra que TIMESTAMP\_CMP retorna um 0 para timestamps idênticos: 

```
select listid, timestamp_cmp(listtime, listtime)
from listing
order by 1 , 2
limit 10;

 listid | timestamp_cmp
--------+---------------
      1 |             0
      2 |             0
      3 |             0
      4 |             0
      5 |             0
      6 |             0
      7 |             0
      8 |             0
      9 |             0
     10 |             0
(10 rows)
```