Función TIMESTAMPTZ_CMP_DATE

TIMESTAMPTZ_CMP_DATE compara el valor de una marca temporal y una fecha. Si los valores de marca temporal y fecha son idénticos, la función devuelve 0. Si la primera marca temporal es mayor, la función devuelve 1. Si la fecha es mayor, la función devuelve –1.

Sintaxis

TIMESTAMPTZ_CMP_DATE(timestamptz, date)

Argumentos

timestamptz

Una columna de tipo de datos TIMESTAMPTZ o una expresión que toma implícitamente el valor de un tipo TIMESTAMPTZ.

date

Una columna de tipo de datos DATE o una expresión que toma implícitamente el valor de un tipo DATE.

Tipo de retorno

INTEGER

Ejemplos

En el siguiente ejemplo se compara LISTTIME como marca temporal con zona horaria con la fecha 2008-06-18. Las listas hechas después de esa fecha devuelven 1; las hechas antes de ella, -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)