src/include/utils/date.h

   1 /*-------------------------------------------------------------------------
   2  *
   3  * date.h
   4  *        Definitions for the SQL92 "date" and "time" types.
   5  *
   6  *
   7  * Portions Copyright (c) 1996-2009, PostgreSQL Global Development Group
   8  * Portions Copyright (c) 1994, Regents of the University of California
   9  *
  10  * $PostgreSQL$
  11  *
  12  *-------------------------------------------------------------------------
  13  */
  14 #ifndef DATE_H
  15 #define DATE_H
  16
  17 #include <math.h>
  18
  19 #include "fmgr.h"
  20
  21
  22 typedef int32 DateADT;
  23
  24 #ifdef HAVE_INT64_TIMESTAMP
  25 typedef int64 TimeADT;
  26 #else
  27 typedef float8 TimeADT;
  28 #endif
  29
  30 typedef struct
  31 {
  32         TimeADT         time;                   /* all time units other than months and years */
  33         int32           zone;                   /* numeric time zone, in seconds */
  34 } TimeTzADT;
  35
  36 /*
  37  * Infinity and minus infinity must be the max and min values of DateADT.
  38  * We could use INT_MIN and INT_MAX here, but seems better to not assume that
  39  * int32 == int.
  40  */
  41 #define DATEVAL_NOBEGIN         ((DateADT) (-0x7fffffff - 1))
  42 #define DATEVAL_NOEND           ((DateADT) 0x7fffffff)
  43
  44 #define DATE_NOBEGIN(j)         ((j) = DATEVAL_NOBEGIN)
  45 #define DATE_IS_NOBEGIN(j)      ((j) == DATEVAL_NOBEGIN)
  46 #define DATE_NOEND(j)           ((j) = DATEVAL_NOEND)
  47 #define DATE_IS_NOEND(j)        ((j) == DATEVAL_NOEND)
  48 #define DATE_NOT_FINITE(j)      (DATE_IS_NOBEGIN(j) || DATE_IS_NOEND(j))
  49
  50 /*
  51  * Macros for fmgr-callable functions.
  52  *
  53  * For TimeADT, we make use of the same support routines as for float8 or int64.
  54  * Therefore TimeADT is pass-by-reference if and only if float8 or int64 is!
  55  */
  56 #ifdef HAVE_INT64_TIMESTAMP
  57
  58 #define MAX_TIME_PRECISION 6
  59
  60 #define DatumGetDateADT(X)        ((DateADT) DatumGetInt32(X))
  61 #define DatumGetTimeADT(X)        ((TimeADT) DatumGetInt64(X))
  62 #define DatumGetTimeTzADTP(X) ((TimeTzADT *) DatumGetPointer(X))
  63
  64 #define DateADTGetDatum(X)        Int32GetDatum(X)
  65 #define TimeADTGetDatum(X)        Int64GetDatum(X)
  66 #define TimeTzADTPGetDatum(X) PointerGetDatum(X)
  67 #else                                                   /* !HAVE_INT64_TIMESTAMP */
  68
  69 #define MAX_TIME_PRECISION 10
  70
  71 /* round off to MAX_TIME_PRECISION decimal places */
  72 #define TIME_PREC_INV 10000000000.0
  73 #define TIMEROUND(j) (rint(((double) (j)) * TIME_PREC_INV) / TIME_PREC_INV)
  74
  75 #define DatumGetDateADT(X)        ((DateADT) DatumGetInt32(X))
  76 #define DatumGetTimeADT(X)        ((TimeADT) DatumGetFloat8(X))
  77 #define DatumGetTimeTzADTP(X) ((TimeTzADT *) DatumGetPointer(X))
  78
  79 #define DateADTGetDatum(X)        Int32GetDatum(X)
  80 #define TimeADTGetDatum(X)        Float8GetDatum(X)
  81 #define TimeTzADTPGetDatum(X) PointerGetDatum(X)
  82 #endif   /* HAVE_INT64_TIMESTAMP */
  83
  84 #define PG_GETARG_DATEADT(n)     DatumGetDateADT(PG_GETARG_DATUM(n))
  85 #define PG_GETARG_TIMEADT(n)     DatumGetTimeADT(PG_GETARG_DATUM(n))
  86 #define PG_GETARG_TIMETZADT_P(n) DatumGetTimeTzADTP(PG_GETARG_DATUM(n))
  87
  88 #define PG_RETURN_DATEADT(x)     return DateADTGetDatum(x)
  89 #define PG_RETURN_TIMEADT(x)     return TimeADTGetDatum(x)
  90 #define PG_RETURN_TIMETZADT_P(x) return TimeTzADTPGetDatum(x)
  91
  92
  93 /* date.c */
  94 extern Datum date_in(PG_FUNCTION_ARGS);
  95 extern Datum date_out(PG_FUNCTION_ARGS);
  96 extern Datum date_recv(PG_FUNCTION_ARGS);
  97 extern Datum date_send(PG_FUNCTION_ARGS);
  98 extern Datum date_eq(PG_FUNCTION_ARGS);
  99 extern Datum date_ne(PG_FUNCTION_ARGS);
 100 extern Datum date_lt(PG_FUNCTION_ARGS);
 101 extern Datum date_le(PG_FUNCTION_ARGS);
 102 extern Datum date_gt(PG_FUNCTION_ARGS);
 103 extern Datum date_ge(PG_FUNCTION_ARGS);
 104 extern Datum date_cmp(PG_FUNCTION_ARGS);
 105 extern Datum date_finite(PG_FUNCTION_ARGS);
 106 extern Datum date_larger(PG_FUNCTION_ARGS);
 107 extern Datum date_smaller(PG_FUNCTION_ARGS);
 108 extern Datum date_mi(PG_FUNCTION_ARGS);
 109 extern Datum date_pli(PG_FUNCTION_ARGS);
 110 extern Datum date_mii(PG_FUNCTION_ARGS);
 111 extern Datum date_eq_timestamp(PG_FUNCTION_ARGS);
 112 extern Datum date_ne_timestamp(PG_FUNCTION_ARGS);
 113 extern Datum date_lt_timestamp(PG_FUNCTION_ARGS);
 114 extern Datum date_le_timestamp(PG_FUNCTION_ARGS);
 115 extern Datum date_gt_timestamp(PG_FUNCTION_ARGS);
 116 extern Datum date_ge_timestamp(PG_FUNCTION_ARGS);
 117 extern Datum date_cmp_timestamp(PG_FUNCTION_ARGS);
 118 extern Datum date_eq_timestamptz(PG_FUNCTION_ARGS);
 119 extern Datum date_ne_timestamptz(PG_FUNCTION_ARGS);
 120 extern Datum date_lt_timestamptz(PG_FUNCTION_ARGS);
 121 extern Datum date_le_timestamptz(PG_FUNCTION_ARGS);
 122 extern Datum date_gt_timestamptz(PG_FUNCTION_ARGS);
 123 extern Datum date_ge_timestamptz(PG_FUNCTION_ARGS);
 124 extern Datum date_cmp_timestamptz(PG_FUNCTION_ARGS);
 125 extern Datum timestamp_eq_date(PG_FUNCTION_ARGS);
 126 extern Datum timestamp_ne_date(PG_FUNCTION_ARGS);
 127 extern Datum timestamp_lt_date(PG_FUNCTION_ARGS);
 128 extern Datum timestamp_le_date(PG_FUNCTION_ARGS);
 129 extern Datum timestamp_gt_date(PG_FUNCTION_ARGS);
 130 extern Datum timestamp_ge_date(PG_FUNCTION_ARGS);
 131 extern Datum timestamp_cmp_date(PG_FUNCTION_ARGS);
 132 extern Datum timestamptz_eq_date(PG_FUNCTION_ARGS);
 133 extern Datum timestamptz_ne_date(PG_FUNCTION_ARGS);
 134 extern Datum timestamptz_lt_date(PG_FUNCTION_ARGS);
 135 extern Datum timestamptz_le_date(PG_FUNCTION_ARGS);
 136 extern Datum timestamptz_gt_date(PG_FUNCTION_ARGS);
 137 extern Datum timestamptz_ge_date(PG_FUNCTION_ARGS);
 138 extern Datum timestamptz_cmp_date(PG_FUNCTION_ARGS);
 139 extern Datum date_pl_interval(PG_FUNCTION_ARGS);
 140 extern Datum date_mi_interval(PG_FUNCTION_ARGS);
 141 extern Datum date_timestamp(PG_FUNCTION_ARGS);
 142 extern Datum timestamp_date(PG_FUNCTION_ARGS);
 143 extern Datum date_timestamptz(PG_FUNCTION_ARGS);
 144 extern Datum timestamptz_date(PG_FUNCTION_ARGS);
 145 extern Datum datetime_timestamp(PG_FUNCTION_ARGS);
 146 extern Datum abstime_date(PG_FUNCTION_ARGS);
 147
 148 extern Datum time_in(PG_FUNCTION_ARGS);
 149 extern Datum time_out(PG_FUNCTION_ARGS);
 150 extern Datum time_recv(PG_FUNCTION_ARGS);
 151 extern Datum time_send(PG_FUNCTION_ARGS);
 152 extern Datum timetypmodin(PG_FUNCTION_ARGS);
 153 extern Datum timetypmodout(PG_FUNCTION_ARGS);
 154 extern Datum time_scale(PG_FUNCTION_ARGS);
 155 extern Datum time_eq(PG_FUNCTION_ARGS);
 156 extern Datum time_ne(PG_FUNCTION_ARGS);
 157 extern Datum time_lt(PG_FUNCTION_ARGS);
 158 extern Datum time_le(PG_FUNCTION_ARGS);
 159 extern Datum time_gt(PG_FUNCTION_ARGS);
 160 extern Datum time_ge(PG_FUNCTION_ARGS);
 161 extern Datum time_cmp(PG_FUNCTION_ARGS);
 162 extern Datum time_hash(PG_FUNCTION_ARGS);
 163 extern Datum overlaps_time(PG_FUNCTION_ARGS);
 164 extern Datum time_larger(PG_FUNCTION_ARGS);
 165 extern Datum time_smaller(PG_FUNCTION_ARGS);
 166 extern Datum time_mi_time(PG_FUNCTION_ARGS);
 167 extern Datum timestamp_time(PG_FUNCTION_ARGS);
 168 extern Datum timestamptz_time(PG_FUNCTION_ARGS);
 169 extern Datum time_interval(PG_FUNCTION_ARGS);
 170 extern Datum interval_time(PG_FUNCTION_ARGS);
 171 extern Datum time_pl_interval(PG_FUNCTION_ARGS);
 172 extern Datum time_mi_interval(PG_FUNCTION_ARGS);
 173 extern Datum time_part(PG_FUNCTION_ARGS);
 174
 175 extern Datum timetz_in(PG_FUNCTION_ARGS);
 176 extern Datum timetz_out(PG_FUNCTION_ARGS);
 177 extern Datum timetz_recv(PG_FUNCTION_ARGS);
 178 extern Datum timetz_send(PG_FUNCTION_ARGS);
 179 extern Datum timetztypmodin(PG_FUNCTION_ARGS);
 180 extern Datum timetztypmodout(PG_FUNCTION_ARGS);
 181 extern Datum timetz_scale(PG_FUNCTION_ARGS);
 182 extern Datum timetz_eq(PG_FUNCTION_ARGS);
 183 extern Datum timetz_ne(PG_FUNCTION_ARGS);
 184 extern Datum timetz_lt(PG_FUNCTION_ARGS);
 185 extern Datum timetz_le(PG_FUNCTION_ARGS);
 186 extern Datum timetz_gt(PG_FUNCTION_ARGS);
 187 extern Datum timetz_ge(PG_FUNCTION_ARGS);
 188 extern Datum timetz_cmp(PG_FUNCTION_ARGS);
 189 extern Datum timetz_hash(PG_FUNCTION_ARGS);
 190 extern Datum overlaps_timetz(PG_FUNCTION_ARGS);
 191 extern Datum timetz_larger(PG_FUNCTION_ARGS);
 192 extern Datum timetz_smaller(PG_FUNCTION_ARGS);
 193 extern Datum timetz_time(PG_FUNCTION_ARGS);
 194 extern Datum time_timetz(PG_FUNCTION_ARGS);
 195 extern Datum timestamptz_timetz(PG_FUNCTION_ARGS);
 196 extern Datum datetimetz_timestamptz(PG_FUNCTION_ARGS);
 197 extern Datum timetz_part(PG_FUNCTION_ARGS);
 198 extern Datum timetz_zone(PG_FUNCTION_ARGS);
 199 extern Datum timetz_izone(PG_FUNCTION_ARGS);
 200 extern Datum timetz_pl_interval(PG_FUNCTION_ARGS);
 201 extern Datum timetz_mi_interval(PG_FUNCTION_ARGS);
 202
 203 #endif   /* DATE_H */