Fonction TIMESTAMPTZ_CMP_DATE

TIMESTAMPTZ_CMP_DATE compare la valeur d’un horodatage et d’une date. Si les valeurs d’horodatage et de date sont identiques, la fonction renvoie 0. Si la valeur d’horodatage est supérieure du point de vue chronologique, la fonction renvoie 1. Si la valeur de date est supérieure, la fonction renvoie –1.

Syntaxe

TIMESTAMPTZ_CMP_DATE(timestamptz, date)

Arguments

timestamptz

Colonne de type de données TIMESTAMPTZ ou expression implicitement évaluée à un type TIMESTAMPTZ.

date

Colonne de type de données DATE ou expression implicitement évaluée à un type DATE.

Type de retour

INTEGER

Exemples

L’exemple suivant compare LISTTIME en tant qu’horodatage avec fuseau horaire à la date 2008-06-18. Les listes faites avant cette date renvoient 1 ; les listes faites après cette date renvoient -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)