1 /*-------------------------------------------------------------------------
4 * Utilities for the built-in type "AbsoluteTime".
5 * Functions for the built-in type "RelativeTime".
6 * Functions for the built-in type "TimeInterval".
8 * Portions Copyright (c) 1996-2005, PostgreSQL Global Development Group
9 * Portions Copyright (c) 1994, Regents of the University of California
13 * $PostgreSQL: pgsql/src/backend/utils/adt/nabstime.c,v 1.146 2005/10/22 14:27:29 adunstan Exp $
15 *-------------------------------------------------------------------------
25 #include "access/xact.h"
26 #include "libpq/pqformat.h"
27 #include "miscadmin.h"
29 #include "utils/builtins.h"
30 #include "utils/nabstime.h"
32 #define MIN_DAYNUM (-24856) /* December 13, 1901 */
33 #define MAX_DAYNUM 24854 /* January 18, 2038 */
35 #define INVALID_RELTIME_STR "Undefined RelTime"
36 #define INVALID_RELTIME_STR_LEN (sizeof(INVALID_RELTIME_STR)-1)
37 #define RELTIME_LABEL '@'
38 #define RELTIME_PAST "ago"
39 #define DIRMAXLEN (sizeof(RELTIME_PAST)-1)
42 * Unix epoch is Jan 1 00:00:00 1970.
43 * Postgres knows about times sixty-eight years on either side of that
44 * for these 4-byte types.
46 * "tinterval" is two 4-byte fields.
47 * Definitions for parsing tinterval.
50 #define IsSpace(C) ((C) == ' ')
52 #define T_INTERVAL_INVAL 0 /* data represents no valid tinterval */
53 #define T_INTERVAL_VALID 1 /* data represents a valid tinterval */
55 * ['Mon May 10 23:59:12 1943 PST' 'Sun Jan 14 03:14:21 1973 PST']
57 * 1234567890123456789012345678901234567890123456789012345678901234
59 * we allocate some extra -- timezones are usually 3 characters but
60 * this is not in the POSIX standard...
62 #define T_INTERVAL_LEN 80
63 #define INVALID_INTERVAL_STR "Undefined Range"
64 #define INVALID_INTERVAL_STR_LEN (sizeof(INVALID_INTERVAL_STR)-1)
66 #define ABSTIMEMIN(t1, t2) \
67 (DatumGetBool(DirectFunctionCall2(abstimele, \
68 AbsoluteTimeGetDatum(t1), \
69 AbsoluteTimeGetDatum(t2))) ? (t1) : (t2))
70 #define ABSTIMEMAX(t1, t2) \
71 (DatumGetBool(DirectFunctionCall2(abstimelt, \
72 AbsoluteTimeGetDatum(t1), \
73 AbsoluteTimeGetDatum(t2))) ? (t2) : (t1))
77 * Function prototypes -- internal to this file only
80 static AbsoluteTime tm2abstime(struct pg_tm * tm, int tz);
81 static void reltime2tm(RelativeTime time, struct pg_tm * tm);
82 static void parsetinterval(char *i_string,
83 AbsoluteTime *i_start,
88 * GetCurrentAbsoluteTime()
90 * Get the current system time (relative to Unix epoch).
93 GetCurrentAbsoluteTime(void)
98 return (AbsoluteTime) now;
103 abstime2tm(AbsoluteTime _time, int *tzp, struct pg_tm * tm, char **tzn)
105 pg_time_t time = (pg_time_t) _time;
109 * If HasCTZSet is true then we have a brute force time zone specified. Go
110 * ahead and rotate to the local time zone since we will later bypass any
111 * calls which adjust the tm fields.
113 if (HasCTZSet && (tzp != NULL))
116 if (!HasCTZSet && tzp != NULL)
117 tx = pg_localtime(&time, global_timezone);
119 tx = pg_gmtime(&time);
121 tm->tm_year = tx->tm_year + 1900;
122 tm->tm_mon = tx->tm_mon + 1;
123 tm->tm_mday = tx->tm_mday;
124 tm->tm_hour = tx->tm_hour;
125 tm->tm_min = tx->tm_min;
126 tm->tm_sec = tx->tm_sec;
127 tm->tm_isdst = tx->tm_isdst;
129 tm->tm_gmtoff = tx->tm_gmtoff;
130 tm->tm_zone = tx->tm_zone;
135 * We have a brute force time zone per SQL99? Then use it without
136 * change since we have already rotated to the time zone.
141 tm->tm_gmtoff = CTimeZone;
149 *tzp = -tm->tm_gmtoff; /* tm_gmtoff is Sun/DEC-ism */
152 * XXX FreeBSD man pages indicate that this should work - tgl
158 * Copy no more than MAXTZLEN bytes of timezone to tzn, in
159 * case it contains an error message, which doesn't fit in the
162 StrNCpy(*tzn, tm->tm_zone, MAXTZLEN + 1);
163 if (strlen(tm->tm_zone) > MAXTZLEN)
165 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
166 errmsg("invalid time zone name: \"%s\"",
177 * Convert a tm structure to abstime.
178 * Note that tm has full year (not 1900-based) and 1-based month.
181 tm2abstime(struct pg_tm * tm, int tz)
186 /* validate, before going out of range on some members */
187 if (tm->tm_year < 1901 || tm->tm_year > 2038 ||
188 tm->tm_mon < 1 || tm->tm_mon > 12 ||
189 tm->tm_mday < 1 || tm->tm_mday > 31 ||
191 tm->tm_hour > 24 || /* test for > 24:00:00 */
192 (tm->tm_hour == 24 && (tm->tm_min > 0 || tm->tm_sec > 0)) ||
193 tm->tm_min < 0 || tm->tm_min > 59 ||
194 tm->tm_sec < 0 || tm->tm_sec > 60)
195 return INVALID_ABSTIME;
197 day = date2j(tm->tm_year, tm->tm_mon, tm->tm_mday) - UNIX_EPOCH_JDATE;
199 /* check for time out of range */
200 if (day < MIN_DAYNUM || day > MAX_DAYNUM)
201 return INVALID_ABSTIME;
203 /* convert to seconds */
204 sec = tm->tm_sec + tz + (tm->tm_min + (day * HOURS_PER_DAY + tm->tm_hour) * MINS_PER_HOUR) * SECS_PER_MINUTE;
207 * check for overflow. We need a little slop here because the H/M/S plus
208 * TZ offset could add up to more than 1 day.
210 if ((day >= MAX_DAYNUM - 10 && sec < 0) ||
211 (day <= MIN_DAYNUM + 10 && sec > 0))
212 return INVALID_ABSTIME;
214 /* check for reserved values (e.g. "current" on edge of usual range */
215 if (!AbsoluteTimeIsReal(sec))
216 return INVALID_ABSTIME;
223 * Decode date/time string and return abstime.
226 abstimein(PG_FUNCTION_ARGS)
228 char *str = PG_GETARG_CSTRING(0);
235 char *field[MAXDATEFIELDS];
236 char workbuf[MAXDATELEN + 1];
239 ftype[MAXDATEFIELDS];
241 dterr = ParseDateTime(str, workbuf, sizeof(workbuf),
242 field, ftype, MAXDATEFIELDS, &nf);
244 dterr = DecodeDateTime(field, ftype, nf, &dtype, tm, &fsec, &tz);
246 DateTimeParseError(dterr, str, "abstime");
251 result = tm2abstime(tm, tz);
257 * Don't bother retaining this as a reserved value, but instead
258 * just set to the actual epoch time (1970-01-01)
264 result = NOEND_ABSTIME;
268 result = NOSTART_ABSTIME;
272 result = INVALID_ABSTIME;
276 elog(ERROR, "unexpected dtype %d while parsing abstime \"%s\"",
278 result = INVALID_ABSTIME;
282 PG_RETURN_ABSOLUTETIME(result);
287 * Given an AbsoluteTime return the English text version of the date
290 abstimeout(PG_FUNCTION_ARGS)
292 AbsoluteTime time = PG_GETARG_ABSOLUTETIME(0);
298 char buf[MAXDATELEN + 1];
299 char zone[MAXDATELEN + 1],
305 * Note that timestamp no longer supports 'invalid'. Retain
306 * 'invalid' for abstime for now, but dump it someday.
308 case INVALID_ABSTIME:
309 strcpy(buf, INVALID);
314 case NOSTART_ABSTIME:
318 abstime2tm(time, &tz, tm, &tzn);
319 EncodeDateTime(tm, fsec, &tz, &tzn, DateStyle, buf);
323 result = pstrdup(buf);
324 PG_RETURN_CSTRING(result);
328 * abstimerecv - converts external binary format to abstime
331 abstimerecv(PG_FUNCTION_ARGS)
333 StringInfo buf = (StringInfo) PG_GETARG_POINTER(0);
335 PG_RETURN_ABSOLUTETIME((AbsoluteTime) pq_getmsgint(buf, sizeof(AbsoluteTime)));
339 * abstimesend - converts abstime to binary format
342 abstimesend(PG_FUNCTION_ARGS)
344 AbsoluteTime time = PG_GETARG_ABSOLUTETIME(0);
347 pq_begintypsend(&buf);
348 pq_sendint(&buf, time, sizeof(time));
349 PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
356 abstime_finite(PG_FUNCTION_ARGS)
358 AbsoluteTime abstime = PG_GETARG_ABSOLUTETIME(0);
360 PG_RETURN_BOOL(abstime != INVALID_ABSTIME &&
361 abstime != NOSTART_ABSTIME &&
362 abstime != NOEND_ABSTIME);
367 * abstime comparison routines
370 abstime_cmp_internal(AbsoluteTime a, AbsoluteTime b)
373 * We consider all INVALIDs to be equal and larger than any non-INVALID.
374 * This is somewhat arbitrary; the important thing is to have a consistent
377 if (a == INVALID_ABSTIME)
379 if (b == INVALID_ABSTIME)
380 return 0; /* INVALID = INVALID */
382 return 1; /* INVALID > non-INVALID */
385 if (b == INVALID_ABSTIME)
386 return -1; /* non-INVALID < INVALID */
397 abstimeeq(PG_FUNCTION_ARGS)
399 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
400 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
402 PG_RETURN_BOOL(abstime_cmp_internal(t1, t2) == 0);
406 abstimene(PG_FUNCTION_ARGS)
408 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
409 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
411 PG_RETURN_BOOL(abstime_cmp_internal(t1, t2) != 0);
415 abstimelt(PG_FUNCTION_ARGS)
417 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
418 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
420 PG_RETURN_BOOL(abstime_cmp_internal(t1, t2) < 0);
424 abstimegt(PG_FUNCTION_ARGS)
426 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
427 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
429 PG_RETURN_BOOL(abstime_cmp_internal(t1, t2) > 0);
433 abstimele(PG_FUNCTION_ARGS)
435 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
436 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
438 PG_RETURN_BOOL(abstime_cmp_internal(t1, t2) <= 0);
442 abstimege(PG_FUNCTION_ARGS)
444 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
445 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
447 PG_RETURN_BOOL(abstime_cmp_internal(t1, t2) >= 0);
451 btabstimecmp(PG_FUNCTION_ARGS)
453 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
454 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
456 PG_RETURN_INT32(abstime_cmp_internal(t1, t2));
460 /* timestamp_abstime()
461 * Convert timestamp to abstime.
464 timestamp_abstime(PG_FUNCTION_ARGS)
466 Timestamp timestamp = PG_GETARG_TIMESTAMP(0);
473 if (TIMESTAMP_IS_NOBEGIN(timestamp))
474 result = NOSTART_ABSTIME;
475 else if (TIMESTAMP_IS_NOEND(timestamp))
476 result = NOEND_ABSTIME;
477 else if (timestamp2tm(timestamp, NULL, tm, &fsec, NULL, NULL) == 0)
479 tz = DetermineTimeZoneOffset(tm, global_timezone);
480 result = tm2abstime(tm, tz);
485 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
486 errmsg("timestamp out of range")));
487 result = INVALID_ABSTIME;
490 PG_RETURN_ABSOLUTETIME(result);
493 /* abstime_timestamp()
494 * Convert abstime to timestamp.
497 abstime_timestamp(PG_FUNCTION_ARGS)
499 AbsoluteTime abstime = PG_GETARG_ABSOLUTETIME(0);
504 char zone[MAXDATELEN + 1],
509 case INVALID_ABSTIME:
511 (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
512 errmsg("cannot convert abstime \"invalid\" to timestamp")));
513 TIMESTAMP_NOBEGIN(result);
516 case NOSTART_ABSTIME:
517 TIMESTAMP_NOBEGIN(result);
521 TIMESTAMP_NOEND(result);
525 abstime2tm(abstime, &tz, tm, &tzn);
526 if (tm2timestamp(tm, 0, NULL, &result) != 0)
528 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
529 errmsg("timestamp out of range")));
533 PG_RETURN_TIMESTAMP(result);
537 /* timestamptz_abstime()
538 * Convert timestamp with time zone to abstime.
541 timestamptz_abstime(PG_FUNCTION_ARGS)
543 TimestampTz timestamp = PG_GETARG_TIMESTAMP(0);
549 if (TIMESTAMP_IS_NOBEGIN(timestamp))
550 result = NOSTART_ABSTIME;
551 else if (TIMESTAMP_IS_NOEND(timestamp))
552 result = NOEND_ABSTIME;
553 else if (timestamp2tm(timestamp, NULL, tm, &fsec, NULL, NULL) == 0)
554 result = tm2abstime(tm, 0);
558 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
559 errmsg("timestamp out of range")));
560 result = INVALID_ABSTIME;
563 PG_RETURN_ABSOLUTETIME(result);
566 /* abstime_timestamptz()
567 * Convert abstime to timestamp with time zone.
570 abstime_timestamptz(PG_FUNCTION_ARGS)
572 AbsoluteTime abstime = PG_GETARG_ABSOLUTETIME(0);
577 char zone[MAXDATELEN + 1],
582 case INVALID_ABSTIME:
584 (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
585 errmsg("cannot convert abstime \"invalid\" to timestamp")));
586 TIMESTAMP_NOBEGIN(result);
589 case NOSTART_ABSTIME:
590 TIMESTAMP_NOBEGIN(result);
594 TIMESTAMP_NOEND(result);
598 abstime2tm(abstime, &tz, tm, &tzn);
599 if (tm2timestamp(tm, 0, &tz, &result) != 0)
601 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
602 errmsg("timestamp out of range")));
606 PG_RETURN_TIMESTAMP(result);
610 /*****************************************************************************
611 * USER I/O ROUTINES *
612 *****************************************************************************/
615 * reltimein - converts a reltime string in an internal format
618 reltimein(PG_FUNCTION_ARGS)
620 char *str = PG_GETARG_CSTRING(0);
627 char *field[MAXDATEFIELDS];
629 ftype[MAXDATEFIELDS];
630 char workbuf[MAXDATELEN + 1];
632 dterr = ParseDateTime(str, workbuf, sizeof(workbuf),
633 field, ftype, MAXDATEFIELDS, &nf);
635 dterr = DecodeInterval(field, ftype, nf, &dtype, tm, &fsec);
638 if (dterr == DTERR_FIELD_OVERFLOW)
639 dterr = DTERR_INTERVAL_OVERFLOW;
640 DateTimeParseError(dterr, str, "reltime");
646 result = ((tm->tm_hour * MINS_PER_HOUR + tm->tm_min) * SECS_PER_MINUTE) + tm->tm_sec;
647 result += tm->tm_year * SECS_PER_YEAR + ((tm->tm_mon * DAYS_PER_MONTH) + tm->tm_mday) * SECS_PER_DAY;
651 elog(ERROR, "unexpected dtype %d while parsing reltime \"%s\"",
653 result = INVALID_RELTIME;
657 PG_RETURN_RELATIVETIME(result);
661 * reltimeout - converts the internal format to a reltime string
664 reltimeout(PG_FUNCTION_ARGS)
666 RelativeTime time = PG_GETARG_RELATIVETIME(0);
670 char buf[MAXDATELEN + 1];
672 reltime2tm(time, tm);
673 EncodeInterval(tm, 0, DateStyle, buf);
675 result = pstrdup(buf);
676 PG_RETURN_CSTRING(result);
680 * reltimerecv - converts external binary format to reltime
683 reltimerecv(PG_FUNCTION_ARGS)
685 StringInfo buf = (StringInfo) PG_GETARG_POINTER(0);
687 PG_RETURN_RELATIVETIME((RelativeTime) pq_getmsgint(buf, sizeof(RelativeTime)));
691 * reltimesend - converts reltime to binary format
694 reltimesend(PG_FUNCTION_ARGS)
696 RelativeTime time = PG_GETARG_RELATIVETIME(0);
699 pq_begintypsend(&buf);
700 pq_sendint(&buf, time, sizeof(time));
701 PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
706 reltime2tm(RelativeTime time, struct pg_tm * tm)
710 FMODULO(dtime, tm->tm_year, 31557600);
711 FMODULO(dtime, tm->tm_mon, 2592000);
712 FMODULO(dtime, tm->tm_mday, SECS_PER_DAY);
713 FMODULO(dtime, tm->tm_hour, SECS_PER_HOUR);
714 FMODULO(dtime, tm->tm_min, SECS_PER_MINUTE);
715 FMODULO(dtime, tm->tm_sec, 1);
720 * tintervalin - converts an tinterval string to internal format
723 tintervalin(PG_FUNCTION_ARGS)
725 char *tintervalstr = PG_GETARG_CSTRING(0);
726 TimeInterval tinterval;
727 AbsoluteTime i_start,
732 parsetinterval(tintervalstr, &t1, &t2);
734 tinterval = (TimeInterval) palloc(sizeof(TimeIntervalData));
736 if (t1 == INVALID_ABSTIME || t2 == INVALID_ABSTIME)
737 tinterval->status = T_INTERVAL_INVAL; /* undefined */
739 tinterval->status = T_INTERVAL_VALID;
741 i_start = ABSTIMEMIN(t1, t2);
742 i_end = ABSTIMEMAX(t1, t2);
743 tinterval->data[0] = i_start;
744 tinterval->data[1] = i_end;
746 PG_RETURN_TIMEINTERVAL(tinterval);
751 * tintervalout - converts an internal tinterval format to a string
754 tintervalout(PG_FUNCTION_ARGS)
756 TimeInterval tinterval = PG_GETARG_TIMEINTERVAL(0);
760 i_str = (char *) palloc(T_INTERVAL_LEN); /* ["..." "..."] */
761 strcpy(i_str, "[\"");
762 if (tinterval->status == T_INTERVAL_INVAL)
763 strcat(i_str, INVALID_INTERVAL_STR);
766 p = DatumGetCString(DirectFunctionCall1(abstimeout,
767 AbsoluteTimeGetDatum(tinterval->data[0])));
770 strcat(i_str, "\" \"");
771 p = DatumGetCString(DirectFunctionCall1(abstimeout,
772 AbsoluteTimeGetDatum(tinterval->data[1])));
776 strcat(i_str, "\"]");
777 PG_RETURN_CSTRING(i_str);
781 * tintervalrecv - converts external binary format to tinterval
784 tintervalrecv(PG_FUNCTION_ARGS)
786 StringInfo buf = (StringInfo) PG_GETARG_POINTER(0);
787 TimeInterval tinterval;
789 tinterval = (TimeInterval) palloc(sizeof(TimeIntervalData));
791 tinterval->status = pq_getmsgint(buf, sizeof(tinterval->status));
793 if (!(tinterval->status == T_INTERVAL_INVAL ||
794 tinterval->status == T_INTERVAL_VALID))
796 (errcode(ERRCODE_INVALID_BINARY_REPRESENTATION),
797 errmsg("invalid status in external \"tinterval\" value")));
799 tinterval->data[0] = pq_getmsgint(buf, sizeof(tinterval->data[0]));
800 tinterval->data[1] = pq_getmsgint(buf, sizeof(tinterval->data[1]));
802 PG_RETURN_TIMEINTERVAL(tinterval);
806 * tintervalsend - converts tinterval to binary format
809 tintervalsend(PG_FUNCTION_ARGS)
811 TimeInterval tinterval = PG_GETARG_TIMEINTERVAL(0);
814 pq_begintypsend(&buf);
815 pq_sendint(&buf, tinterval->status, sizeof(tinterval->status));
816 pq_sendint(&buf, tinterval->data[0], sizeof(tinterval->data[0]));
817 pq_sendint(&buf, tinterval->data[1], sizeof(tinterval->data[1]));
818 PG_RETURN_BYTEA_P(pq_endtypsend(&buf));
822 /*****************************************************************************
824 *****************************************************************************/
827 interval_reltime(PG_FUNCTION_ARGS)
829 Interval *interval = PG_GETARG_INTERVAL_P(0);
835 #ifdef HAVE_INT64_TIMESTAMP
841 year = interval->month / MONTHS_PER_YEAR;
842 month = interval->month % MONTHS_PER_YEAR;
845 #ifdef HAVE_INT64_TIMESTAMP
846 span = ((INT64CONST(365250000) * year + INT64CONST(30000000) * month +
847 INT64CONST(1000000) * day) * INT64CONST(86400)) +
849 span /= USECS_PER_SEC;
851 span = (DAYS_PER_YEAR * year + (double) DAYS_PER_MONTH * month + day) * SECS_PER_DAY + interval->time;
854 if (span < INT_MIN || span > INT_MAX)
855 time = INVALID_RELTIME;
859 PG_RETURN_RELATIVETIME(time);
864 reltime_interval(PG_FUNCTION_ARGS)
866 RelativeTime reltime = PG_GETARG_RELATIVETIME(0);
872 result = (Interval *) palloc(sizeof(Interval));
876 case INVALID_RELTIME:
878 (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
879 errmsg("cannot convert reltime \"invalid\" to interval")));
886 #ifdef HAVE_INT64_TIMESTAMP
887 year = reltime / SECS_PER_YEAR;
888 reltime -= year * SECS_PER_YEAR;
889 month = reltime / (DAYS_PER_MONTH * SECS_PER_DAY);
890 reltime -= month * (DAYS_PER_MONTH * SECS_PER_DAY);
891 day = reltime / SECS_PER_DAY;
892 reltime -= day * SECS_PER_DAY;
894 result->time = (reltime * USECS_PER_SEC);
896 TMODULO(reltime, year, SECS_PER_YEAR);
897 TMODULO(reltime, month, DAYS_PER_MONTH * SECS_PER_DAY);
898 TMODULO(reltime, day, SECS_PER_DAY);
900 result->time = reltime;
902 result->month = MONTHS_PER_YEAR * year + month;
907 PG_RETURN_INTERVAL_P(result);
912 * mktinterval - creates a time interval with endpoints t1 and t2
915 mktinterval(PG_FUNCTION_ARGS)
917 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
918 AbsoluteTime t2 = PG_GETARG_ABSOLUTETIME(1);
919 AbsoluteTime tstart = ABSTIMEMIN(t1, t2);
920 AbsoluteTime tend = ABSTIMEMAX(t1, t2);
921 TimeInterval tinterval;
923 tinterval = (TimeInterval) palloc(sizeof(TimeIntervalData));
925 if (t1 == INVALID_ABSTIME || t2 == INVALID_ABSTIME)
926 tinterval->status = T_INTERVAL_INVAL;
930 tinterval->status = T_INTERVAL_VALID;
931 tinterval->data[0] = tstart;
932 tinterval->data[1] = tend;
935 PG_RETURN_TIMEINTERVAL(tinterval);
939 * timepl, timemi and abstimemi use the formula
940 * abstime + reltime = abstime
941 * so abstime - reltime = abstime
942 * and abstime - abstime = reltime
946 * timepl - returns the value of (abstime t1 + reltime t2)
949 timepl(PG_FUNCTION_ARGS)
951 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
952 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
954 if (AbsoluteTimeIsReal(t1) &&
955 RelativeTimeIsValid(t2) &&
956 ((t2 > 0 && t1 < NOEND_ABSTIME - t2) ||
957 (t2 <= 0 && t1 > NOSTART_ABSTIME - t2))) /* prevent overflow */
958 PG_RETURN_ABSOLUTETIME(t1 + t2);
960 PG_RETURN_ABSOLUTETIME(INVALID_ABSTIME);
965 * timemi - returns the value of (abstime t1 - reltime t2)
968 timemi(PG_FUNCTION_ARGS)
970 AbsoluteTime t1 = PG_GETARG_ABSOLUTETIME(0);
971 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
973 if (AbsoluteTimeIsReal(t1) &&
974 RelativeTimeIsValid(t2) &&
975 ((t2 > 0 && t1 > NOSTART_ABSTIME + t2) ||
976 (t2 <= 0 && t1 < NOEND_ABSTIME + t2))) /* prevent overflow */
977 PG_RETURN_ABSOLUTETIME(t1 - t2);
979 PG_RETURN_ABSOLUTETIME(INVALID_ABSTIME);
984 * intinterval - returns true iff absolute date is in the tinterval
987 intinterval(PG_FUNCTION_ARGS)
989 AbsoluteTime t = PG_GETARG_ABSOLUTETIME(0);
990 TimeInterval tinterval = PG_GETARG_TIMEINTERVAL(1);
992 if (tinterval->status == T_INTERVAL_VALID && t != INVALID_ABSTIME)
994 if (DatumGetBool(DirectFunctionCall2(abstimege,
995 AbsoluteTimeGetDatum(t),
996 AbsoluteTimeGetDatum(tinterval->data[0]))) &&
997 DatumGetBool(DirectFunctionCall2(abstimele,
998 AbsoluteTimeGetDatum(t),
999 AbsoluteTimeGetDatum(tinterval->data[1]))))
1000 PG_RETURN_BOOL(true);
1002 PG_RETURN_BOOL(false);
1006 * tintervalrel - returns relative time corresponding to tinterval
1009 tintervalrel(PG_FUNCTION_ARGS)
1011 TimeInterval tinterval = PG_GETARG_TIMEINTERVAL(0);
1012 AbsoluteTime t1 = tinterval->data[0];
1013 AbsoluteTime t2 = tinterval->data[1];
1015 if (tinterval->status != T_INTERVAL_VALID)
1016 PG_RETURN_RELATIVETIME(INVALID_RELTIME);
1018 if (AbsoluteTimeIsReal(t1) &&
1019 AbsoluteTimeIsReal(t2))
1020 PG_RETURN_RELATIVETIME(t2 - t1);
1022 PG_RETURN_RELATIVETIME(INVALID_RELTIME);
1027 * timenow - returns time "now", internal format
1029 * Now AbsoluteTime is time since Jan 1 1970 -mer 7 Feb 1992
1032 timenow(PG_FUNCTION_ARGS)
1037 PG_RETURN_ABSOLUTETIME(INVALID_ABSTIME);
1039 PG_RETURN_ABSOLUTETIME((AbsoluteTime) sec);
1043 * reltime comparison routines
1046 reltime_cmp_internal(RelativeTime a, RelativeTime b)
1049 * We consider all INVALIDs to be equal and larger than any non-INVALID.
1050 * This is somewhat arbitrary; the important thing is to have a consistent
1053 if (a == INVALID_RELTIME)
1055 if (b == INVALID_RELTIME)
1056 return 0; /* INVALID = INVALID */
1058 return 1; /* INVALID > non-INVALID */
1061 if (b == INVALID_RELTIME)
1062 return -1; /* non-INVALID < INVALID */
1073 reltimeeq(PG_FUNCTION_ARGS)
1075 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1076 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1078 PG_RETURN_BOOL(reltime_cmp_internal(t1, t2) == 0);
1082 reltimene(PG_FUNCTION_ARGS)
1084 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1085 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1087 PG_RETURN_BOOL(reltime_cmp_internal(t1, t2) != 0);
1091 reltimelt(PG_FUNCTION_ARGS)
1093 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1094 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1096 PG_RETURN_BOOL(reltime_cmp_internal(t1, t2) < 0);
1100 reltimegt(PG_FUNCTION_ARGS)
1102 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1103 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1105 PG_RETURN_BOOL(reltime_cmp_internal(t1, t2) > 0);
1109 reltimele(PG_FUNCTION_ARGS)
1111 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1112 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1114 PG_RETURN_BOOL(reltime_cmp_internal(t1, t2) <= 0);
1118 reltimege(PG_FUNCTION_ARGS)
1120 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1121 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1123 PG_RETURN_BOOL(reltime_cmp_internal(t1, t2) >= 0);
1127 btreltimecmp(PG_FUNCTION_ARGS)
1129 RelativeTime t1 = PG_GETARG_RELATIVETIME(0);
1130 RelativeTime t2 = PG_GETARG_RELATIVETIME(1);
1132 PG_RETURN_INT32(reltime_cmp_internal(t1, t2));
1137 * tintervalsame - returns true iff tinterval i1 is same as tinterval i2
1138 * Check begin and end time.
1141 tintervalsame(PG_FUNCTION_ARGS)
1143 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1144 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1146 if (i1->status == T_INTERVAL_INVAL || i2->status == T_INTERVAL_INVAL)
1147 PG_RETURN_BOOL(false);
1149 if (DatumGetBool(DirectFunctionCall2(abstimeeq,
1150 AbsoluteTimeGetDatum(i1->data[0]),
1151 AbsoluteTimeGetDatum(i2->data[0]))) &&
1152 DatumGetBool(DirectFunctionCall2(abstimeeq,
1153 AbsoluteTimeGetDatum(i1->data[1]),
1154 AbsoluteTimeGetDatum(i2->data[1]))))
1155 PG_RETURN_BOOL(true);
1156 PG_RETURN_BOOL(false);
1160 * tinterval comparison routines
1162 * Note: comparison is based on the lengths of the tintervals, not on
1163 * endpoint value. This is pretty bogus, but since it's only a legacy
1164 * datatype I'm not going to propose changing it.
1167 tinterval_cmp_internal(TimeInterval a, TimeInterval b)
1175 * We consider all INVALIDs to be equal and larger than any non-INVALID.
1176 * This is somewhat arbitrary; the important thing is to have a consistent
1179 a_invalid = a->status == T_INTERVAL_INVAL ||
1180 a->data[0] == INVALID_ABSTIME ||
1181 a->data[1] == INVALID_ABSTIME;
1182 b_invalid = b->status == T_INTERVAL_INVAL ||
1183 b->data[0] == INVALID_ABSTIME ||
1184 b->data[1] == INVALID_ABSTIME;
1189 return 0; /* INVALID = INVALID */
1191 return 1; /* INVALID > non-INVALID */
1195 return -1; /* non-INVALID < INVALID */
1197 a_len = a->data[1] - a->data[0];
1198 b_len = b->data[1] - b->data[0];
1202 else if (a_len == b_len)
1209 tintervaleq(PG_FUNCTION_ARGS)
1211 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1212 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1214 PG_RETURN_BOOL(tinterval_cmp_internal(i1, i2) == 0);
1218 tintervalne(PG_FUNCTION_ARGS)
1220 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1221 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1223 PG_RETURN_BOOL(tinterval_cmp_internal(i1, i2) != 0);
1227 tintervallt(PG_FUNCTION_ARGS)
1229 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1230 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1232 PG_RETURN_BOOL(tinterval_cmp_internal(i1, i2) < 0);
1236 tintervalle(PG_FUNCTION_ARGS)
1238 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1239 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1241 PG_RETURN_BOOL(tinterval_cmp_internal(i1, i2) <= 0);
1245 tintervalgt(PG_FUNCTION_ARGS)
1247 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1248 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1250 PG_RETURN_BOOL(tinterval_cmp_internal(i1, i2) > 0);
1254 tintervalge(PG_FUNCTION_ARGS)
1256 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1257 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1259 PG_RETURN_BOOL(tinterval_cmp_internal(i1, i2) >= 0);
1263 bttintervalcmp(PG_FUNCTION_ARGS)
1265 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1266 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1268 PG_RETURN_INT32(tinterval_cmp_internal(i1, i2));
1273 * tintervalleneq - returns true iff length of tinterval i is equal to
1275 * tintervallenne - returns true iff length of tinterval i is not equal
1277 * tintervallenlt - returns true iff length of tinterval i is less than
1279 * tintervallengt - returns true iff length of tinterval i is greater
1281 * tintervallenle - returns true iff length of tinterval i is less or
1282 * equal than reltime t
1283 * tintervallenge - returns true iff length of tinterval i is greater or
1284 * equal than reltime t
1287 tintervalleneq(PG_FUNCTION_ARGS)
1289 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1290 RelativeTime t = PG_GETARG_RELATIVETIME(1);
1293 if (i->status == T_INTERVAL_INVAL || t == INVALID_RELTIME)
1294 PG_RETURN_BOOL(false);
1295 rt = DatumGetRelativeTime(DirectFunctionCall1(tintervalrel,
1296 TimeIntervalGetDatum(i)));
1297 PG_RETURN_BOOL(rt != INVALID_RELTIME && rt == t);
1301 tintervallenne(PG_FUNCTION_ARGS)
1303 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1304 RelativeTime t = PG_GETARG_RELATIVETIME(1);
1307 if (i->status == T_INTERVAL_INVAL || t == INVALID_RELTIME)
1308 PG_RETURN_BOOL(false);
1309 rt = DatumGetRelativeTime(DirectFunctionCall1(tintervalrel,
1310 TimeIntervalGetDatum(i)));
1311 PG_RETURN_BOOL(rt != INVALID_RELTIME && rt != t);
1315 tintervallenlt(PG_FUNCTION_ARGS)
1317 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1318 RelativeTime t = PG_GETARG_RELATIVETIME(1);
1321 if (i->status == T_INTERVAL_INVAL || t == INVALID_RELTIME)
1322 PG_RETURN_BOOL(false);
1323 rt = DatumGetRelativeTime(DirectFunctionCall1(tintervalrel,
1324 TimeIntervalGetDatum(i)));
1325 PG_RETURN_BOOL(rt != INVALID_RELTIME && rt < t);
1329 tintervallengt(PG_FUNCTION_ARGS)
1331 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1332 RelativeTime t = PG_GETARG_RELATIVETIME(1);
1335 if (i->status == T_INTERVAL_INVAL || t == INVALID_RELTIME)
1336 PG_RETURN_BOOL(false);
1337 rt = DatumGetRelativeTime(DirectFunctionCall1(tintervalrel,
1338 TimeIntervalGetDatum(i)));
1339 PG_RETURN_BOOL(rt != INVALID_RELTIME && rt > t);
1343 tintervallenle(PG_FUNCTION_ARGS)
1345 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1346 RelativeTime t = PG_GETARG_RELATIVETIME(1);
1349 if (i->status == T_INTERVAL_INVAL || t == INVALID_RELTIME)
1350 PG_RETURN_BOOL(false);
1351 rt = DatumGetRelativeTime(DirectFunctionCall1(tintervalrel,
1352 TimeIntervalGetDatum(i)));
1353 PG_RETURN_BOOL(rt != INVALID_RELTIME && rt <= t);
1357 tintervallenge(PG_FUNCTION_ARGS)
1359 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1360 RelativeTime t = PG_GETARG_RELATIVETIME(1);
1363 if (i->status == T_INTERVAL_INVAL || t == INVALID_RELTIME)
1364 PG_RETURN_BOOL(false);
1365 rt = DatumGetRelativeTime(DirectFunctionCall1(tintervalrel,
1366 TimeIntervalGetDatum(i)));
1367 PG_RETURN_BOOL(rt != INVALID_RELTIME && rt >= t);
1371 * tintervalct - returns true iff tinterval i1 contains tinterval i2
1374 tintervalct(PG_FUNCTION_ARGS)
1376 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1377 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1379 if (i1->status == T_INTERVAL_INVAL || i2->status == T_INTERVAL_INVAL)
1380 PG_RETURN_BOOL(false);
1381 if (DatumGetBool(DirectFunctionCall2(abstimele,
1382 AbsoluteTimeGetDatum(i1->data[0]),
1383 AbsoluteTimeGetDatum(i2->data[0]))) &&
1384 DatumGetBool(DirectFunctionCall2(abstimege,
1385 AbsoluteTimeGetDatum(i1->data[1]),
1386 AbsoluteTimeGetDatum(i2->data[1]))))
1387 PG_RETURN_BOOL(true);
1388 PG_RETURN_BOOL(false);
1392 * tintervalov - returns true iff tinterval i1 (partially) overlaps i2
1395 tintervalov(PG_FUNCTION_ARGS)
1397 TimeInterval i1 = PG_GETARG_TIMEINTERVAL(0);
1398 TimeInterval i2 = PG_GETARG_TIMEINTERVAL(1);
1400 if (i1->status == T_INTERVAL_INVAL || i2->status == T_INTERVAL_INVAL)
1401 PG_RETURN_BOOL(false);
1402 if (DatumGetBool(DirectFunctionCall2(abstimelt,
1403 AbsoluteTimeGetDatum(i1->data[1]),
1404 AbsoluteTimeGetDatum(i2->data[0]))) ||
1405 DatumGetBool(DirectFunctionCall2(abstimegt,
1406 AbsoluteTimeGetDatum(i1->data[0]),
1407 AbsoluteTimeGetDatum(i2->data[1]))))
1408 PG_RETURN_BOOL(false);
1409 PG_RETURN_BOOL(true);
1413 * tintervalstart - returns the start of tinterval i
1416 tintervalstart(PG_FUNCTION_ARGS)
1418 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1420 if (i->status == T_INTERVAL_INVAL)
1421 PG_RETURN_ABSOLUTETIME(INVALID_ABSTIME);
1422 PG_RETURN_ABSOLUTETIME(i->data[0]);
1426 * tintervalend - returns the end of tinterval i
1429 tintervalend(PG_FUNCTION_ARGS)
1431 TimeInterval i = PG_GETARG_TIMEINTERVAL(0);
1433 if (i->status == T_INTERVAL_INVAL)
1434 PG_RETURN_ABSOLUTETIME(INVALID_ABSTIME);
1435 PG_RETURN_ABSOLUTETIME(i->data[1]);
1439 /*****************************************************************************
1440 * PRIVATE ROUTINES *
1441 *****************************************************************************/
1444 * parsetinterval -- parse a tinterval string
1446 * output parameters:
1447 * i_start, i_end: tinterval margins
1450 * `[' {` '} `'' <AbsTime> `'' {` '} `'' <AbsTime> `'' {` '} `]'
1452 * OR `Undefined Range' (see also INVALID_INTERVAL_STR)
1454 * where <AbsTime> satisfies the syntax of absolute time.
1456 * e.g. [ ' Jan 18 1902' 'Jan 1 00:00:00 1970']
1459 parsetinterval(char *i_string,
1460 AbsoluteTime *i_start,
1461 AbsoluteTime *i_end)
1468 /* skip leading blanks up to '[' */
1469 while ((c = *p) != '\0')
1474 goto bogus; /* syntax error */
1479 goto bogus; /* syntax error */
1481 /* skip leading blanks up to '"' */
1482 while ((c = *p) != '\0')
1487 goto bogus; /* syntax error */
1492 goto bogus; /* syntax error */
1494 if (strncmp(INVALID_INTERVAL_STR, p, strlen(INVALID_INTERVAL_STR)) == 0)
1495 goto bogus; /* undefined range, handled like a syntax err. */
1496 /* search for the end of the first date and change it to a \0 */
1498 while ((c = *p1) != '\0')
1505 goto bogus; /* syntax error */
1507 /* get the first date */
1508 *i_start = DatumGetAbsoluteTime(DirectFunctionCall1(abstimein,
1509 CStringGetDatum(p)));
1510 /* undo change to \0 */
1513 /* skip blanks up to '"', beginning of second date */
1514 while ((c = *p) != '\0')
1519 goto bogus; /* syntax error */
1524 goto bogus; /* syntax error */
1526 /* search for the end of the second date and change it to a \0 */
1528 while ((c = *p1) != '\0')
1535 goto bogus; /* syntax error */
1537 /* get the second date */
1538 *i_end = DatumGetAbsoluteTime(DirectFunctionCall1(abstimein,
1539 CStringGetDatum(p)));
1540 /* undo change to \0 */
1543 /* skip blanks up to ']' */
1544 while ((c = *p) != '\0')
1549 goto bogus; /* syntax error */
1554 goto bogus; /* syntax error */
1558 goto bogus; /* syntax error */
1560 /* it seems to be a valid tinterval */
1565 (errcode(ERRCODE_INVALID_DATETIME_FORMAT),
1566 errmsg("invalid input syntax for type tinterval: \"%s\"",
1568 *i_start = *i_end = INVALID_ABSTIME; /* keep compiler quiet */
1572 /*****************************************************************************
1574 *****************************************************************************/
1578 * returns the current time as a text. similar to timenow() but returns
1579 * seconds with more precision (up to microsecs). (I need this to compare
1580 * the Wisconsin benchmark with Illustra whose TimeNow() shows current
1581 * time with precision up to microsecs.) - ay 3/95
1584 timeofday(PG_FUNCTION_ARGS)
1593 gettimeofday(&tp, NULL);
1594 tt = (pg_time_t) tp.tv_sec;
1595 pg_strftime(templ, sizeof(templ), "%a %b %d %H:%M:%S.%%06d %Y %Z",
1596 pg_localtime(&tt, global_timezone));
1597 snprintf(buf, sizeof(buf), templ, tp.tv_usec);
1599 len = VARHDRSZ + strlen(buf);
1600 result = (text *) palloc(len);
1601 VARATT_SIZEP(result) = len;
1602 memcpy(VARDATA(result), buf, strlen(buf));
1603 PG_RETURN_TEXT_P(result);