PostgreSQL Source Code  git master
date.h
Go to the documentation of this file.
1 /*-------------------------------------------------------------------------
2  *
3  * date.h
4  * Definitions for the SQL "date" and "time" types.
5  *
6  *
7  * Portions Copyright (c) 1996-2022, PostgreSQL Global Development Group
8  * Portions Copyright (c) 1994, Regents of the University of California
9  *
10  * src/include/utils/date.h
11  *
12  *-------------------------------------------------------------------------
13  */
14 #ifndef DATE_H
15 #define DATE_H
16 
17 #include <math.h>
18 
19 #include "datatype/timestamp.h"
20 #include "fmgr.h"
21 #include "pgtime.h"
22 
23 typedef int32 DateADT;
24 
25 typedef int64 TimeADT;
26 
27 typedef struct
28 {
29  TimeADT time; /* all time units other than months and years */
30  int32 zone; /* numeric time zone, in seconds */
31 } TimeTzADT;
32 
33 /*
34  * Infinity and minus infinity must be the max and min values of DateADT.
35  */
36 #define DATEVAL_NOBEGIN ((DateADT) PG_INT32_MIN)
37 #define DATEVAL_NOEND ((DateADT) PG_INT32_MAX)
38 
39 #define DATE_NOBEGIN(j) ((j) = DATEVAL_NOBEGIN)
40 #define DATE_IS_NOBEGIN(j) ((j) == DATEVAL_NOBEGIN)
41 #define DATE_NOEND(j) ((j) = DATEVAL_NOEND)
42 #define DATE_IS_NOEND(j) ((j) == DATEVAL_NOEND)
43 #define DATE_NOT_FINITE(j) (DATE_IS_NOBEGIN(j) || DATE_IS_NOEND(j))
44 
45 #define MAX_TIME_PRECISION 6
46 
47 /*
48  * Functions for fmgr-callable functions.
49  *
50  * For TimeADT, we make use of the same support routines as for int64.
51  * Therefore TimeADT is pass-by-reference if and only if int64 is!
52  */
53 static inline DateADT
55 {
56  return (DateADT) DatumGetInt32(X);
57 }
58 
59 static inline TimeADT
61 {
62  return (TimeADT) DatumGetInt64(X);
63 }
64 
65 static inline TimeTzADT *
67 {
68  return (TimeTzADT *) DatumGetPointer(X);
69 }
70 
71 static inline Datum
73 {
74  return Int32GetDatum(X);
75 }
76 
77 static inline Datum
79 {
80  return Int64GetDatum(X);
81 }
82 
83 static inline Datum
85 {
86  return PointerGetDatum(X);
87 }
88 
89 #define PG_GETARG_DATEADT(n) DatumGetDateADT(PG_GETARG_DATUM(n))
90 #define PG_GETARG_TIMEADT(n) DatumGetTimeADT(PG_GETARG_DATUM(n))
91 #define PG_GETARG_TIMETZADT_P(n) DatumGetTimeTzADTP(PG_GETARG_DATUM(n))
92 
93 #define PG_RETURN_DATEADT(x) return DateADTGetDatum(x)
94 #define PG_RETURN_TIMEADT(x) return TimeADTGetDatum(x)
95 #define PG_RETURN_TIMETZADT_P(x) return TimeTzADTPGetDatum(x)
96 
97 
98 /* date.c */
99 extern double date2timestamp_no_overflow(DateADT dateVal);
100 extern Timestamp date2timestamp_opt_overflow(DateADT dateVal, int *overflow);
101 extern TimestampTz date2timestamptz_opt_overflow(DateADT dateVal, int *overflow);
104 
105 extern void EncodeSpecialDate(DateADT dt, char *str);
106 extern int time2tm(TimeADT time, struct pg_tm *tm, fsec_t *fsec);
107 extern int timetz2tm(TimeTzADT *time, struct pg_tm *tm, fsec_t *fsec, int *tzp);
108 extern int tm2time(struct pg_tm *tm, fsec_t fsec, TimeADT *result);
109 extern int tm2timetz(struct pg_tm *tm, fsec_t fsec, int tz, TimeTzADT *result);
110 extern bool time_overflows(int hour, int min, int sec, fsec_t fsec);
111 extern bool float_time_overflows(int hour, int min, double sec);
112 extern void AdjustTimeForTypmod(TimeADT *time, int32 typmod);
113 
114 #endif /* DATE_H */
signed int int32
Definition: c.h:430
int64 Timestamp
Definition: timestamp.h:38
int64 TimestampTz
Definition: timestamp.h:39
int32 fsec_t
Definition: timestamp.h:41
int32 date_cmp_timestamp_internal(DateADT dateVal, Timestamp dt2)
Definition: date.c:751
int timetz2tm(TimeTzADT *time, struct pg_tm *tm, fsec_t *fsec, int *tzp)
Definition: date.c:2392
static Datum DateADTGetDatum(DateADT X)
Definition: date.h:72
bool float_time_overflows(int hour, int min, double sec)
Definition: date.c:1454
int tm2time(struct pg_tm *tm, fsec_t fsec, TimeADT *result)
Definition: date.c:1419
int tm2timetz(struct pg_tm *tm, fsec_t fsec, int tz, TimeTzADT *result)
Definition: date.c:2258
bool time_overflows(int hour, int min, int sec, fsec_t fsec)
Definition: date.c:1430
int32 DateADT
Definition: date.h:23
static DateADT DatumGetDateADT(Datum X)
Definition: date.h:54
static TimeADT DatumGetTimeADT(Datum X)
Definition: date.h:60
void AdjustTimeForTypmod(TimeADT *time, int32 typmod)
Definition: date.c:1648
static Datum TimeTzADTPGetDatum(const TimeTzADT *X)
Definition: date.h:84
static TimeTzADT * DatumGetTimeTzADTP(Datum X)
Definition: date.h:66
int64 TimeADT
Definition: date.h:25
TimestampTz date2timestamptz_opt_overflow(DateADT dateVal, int *overflow)
Definition: date.c:632
int time2tm(TimeADT time, struct pg_tm *tm, fsec_t *fsec)
Definition: date.c:1491
void EncodeSpecialDate(DateADT dt, char *str)
Definition: date.c:286
Timestamp date2timestamp_opt_overflow(DateADT dateVal, int *overflow)
Definition: date.c:572
static Datum TimeADTGetDatum(TimeADT X)
Definition: date.h:78
int32 date_cmp_timestamptz_internal(DateADT dateVal, TimestampTz dt2)
Definition: date.c:831
double date2timestamp_no_overflow(DateADT dateVal)
Definition: date.c:728
Datum Int64GetDatum(int64 X)
Definition: fmgr.c:1683
static struct pg_tm tm
Definition: localtime.c:104
static int64 DatumGetInt64(Datum X)
Definition: postgres.h:733
static Datum PointerGetDatum(const void *X)
Definition: postgres.h:670
uintptr_t Datum
Definition: postgres.h:412
static Pointer DatumGetPointer(Datum X)
Definition: postgres.h:660
static Datum Int32GetDatum(int32 X)
Definition: postgres.h:560
static int32 DatumGetInt32(Datum X)
Definition: postgres.h:550
Definition: date.h:28
TimeADT time
Definition: date.h:29
int32 zone
Definition: date.h:30
Definition: pgtime.h:35