mirror of https://github.com/postgres/postgres
As per my recent proposal, this refactors things so that these typedefs and macros are available in a header that can be included in frontend-ish code. I also changed various headers that were undesirably including utils/timestamp.h to include datatype/timestamp.h instead. Unsurprisingly, this showed that half the system was getting utils/timestamp.h by way of xlog.h. No actual code changes here, just header refactoring.pull/1/head
Tom Lane
14 years ago
parent
d63de337f3
commit
a7801b62f2
@ -0,0 +1,163 @@ |
|||||||
|
/*-------------------------------------------------------------------------
|
||||||
|
* |
||||||
|
* timestamp.h |
||||||
|
* Timestamp and Interval typedefs and related macros. |
||||||
|
* |
||||||
|
* Note: this file must be includable in both frontend and backend contexts. |
||||||
|
* |
||||||
|
* Portions Copyright (c) 1996-2011, PostgreSQL Global Development Group |
||||||
|
* Portions Copyright (c) 1994, Regents of the University of California |
||||||
|
* |
||||||
|
* src/include/datatype/timestamp.h |
||||||
|
* |
||||||
|
*------------------------------------------------------------------------- |
||||||
|
*/ |
||||||
|
#ifndef DATATYPE_TIMESTAMP_H |
||||||
|
#define DATATYPE_TIMESTAMP_H |
||||||
|
|
||||||
|
#include <math.h> |
||||||
|
#include <limits.h> |
||||||
|
#include <float.h> |
||||||
|
|
||||||
|
/*
|
||||||
|
* Timestamp represents absolute time. |
||||||
|
* |
||||||
|
* Interval represents delta time. Keep track of months (and years), days, |
||||||
|
* and hours/minutes/seconds separately since the elapsed time spanned is |
||||||
|
* unknown until instantiated relative to an absolute time. |
||||||
|
* |
||||||
|
* Note that Postgres uses "time interval" to mean a bounded interval, |
||||||
|
* consisting of a beginning and ending time, not a time span - thomas 97/03/20 |
||||||
|
* |
||||||
|
* We have two implementations, one that uses int64 values with units of |
||||||
|
* microseconds, and one that uses double values with units of seconds. |
||||||
|
* |
||||||
|
* TimeOffset and fsec_t are convenience typedefs for temporary variables |
||||||
|
* that are of different types in the two cases. Do not use fsec_t in values |
||||||
|
* stored on-disk, since it is not the same size in both implementations. |
||||||
|
* Also, fsec_t is only meant for *fractional* seconds; beware of overflow |
||||||
|
* if the value you need to store could be many seconds. |
||||||
|
*/ |
||||||
|
|
||||||
|
#ifdef HAVE_INT64_TIMESTAMP |
||||||
|
|
||||||
|
typedef int64 Timestamp; |
||||||
|
typedef int64 TimestampTz; |
||||||
|
typedef int64 TimeOffset; |
||||||
|
typedef int32 fsec_t; /* fractional seconds (in microseconds) */ |
||||||
|
#else |
||||||
|
|
||||||
|
typedef double Timestamp; |
||||||
|
typedef double TimestampTz; |
||||||
|
typedef double TimeOffset; |
||||||
|
typedef double fsec_t; /* fractional seconds (in seconds) */ |
||||||
|
#endif |
||||||
|
|
||||||
|
typedef struct |
||||||
|
{ |
||||||
|
TimeOffset time; /* all time units other than days, months and
|
||||||
|
* years */ |
||||||
|
int32 day; /* days, after time for alignment */ |
||||||
|
int32 month; /* months and years, after time for alignment */ |
||||||
|
} Interval; |
||||||
|
|
||||||
|
|
||||||
|
#define MAX_TIMESTAMP_PRECISION 6 |
||||||
|
#define MAX_INTERVAL_PRECISION 6 |
||||||
|
|
||||||
|
/*
|
||||||
|
* Round off to MAX_TIMESTAMP_PRECISION decimal places. |
||||||
|
* Note: this is also used for rounding off intervals. |
||||||
|
*/ |
||||||
|
#define TS_PREC_INV 1000000.0 |
||||||
|
#define TSROUND(j) (rint(((double) (j)) * TS_PREC_INV) / TS_PREC_INV) |
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Assorted constants for datetime-related calculations |
||||||
|
*/ |
||||||
|
|
||||||
|
#define DAYS_PER_YEAR 365.25 /* assumes leap year every four years */ |
||||||
|
#define MONTHS_PER_YEAR 12 |
||||||
|
/*
|
||||||
|
* DAYS_PER_MONTH is very imprecise. The more accurate value is |
||||||
|
* 365.2425/12 = 30.436875, or '30 days 10:29:06'. Right now we only |
||||||
|
* return an integral number of days, but someday perhaps we should |
||||||
|
* also return a 'time' value to be used as well. ISO 8601 suggests |
||||||
|
* 30 days. |
||||||
|
*/ |
||||||
|
#define DAYS_PER_MONTH 30 /* assumes exactly 30 days per month */ |
||||||
|
#define HOURS_PER_DAY 24 /* assume no daylight savings time changes */ |
||||||
|
|
||||||
|
/*
|
||||||
|
* This doesn't adjust for uneven daylight savings time intervals or leap |
||||||
|
* seconds, and it crudely estimates leap years. A more accurate value |
||||||
|
* for days per years is 365.2422. |
||||||
|
*/ |
||||||
|
#define SECS_PER_YEAR (36525 * 864) /* avoid floating-point computation */ |
||||||
|
#define SECS_PER_DAY 86400 |
||||||
|
#define SECS_PER_HOUR 3600 |
||||||
|
#define SECS_PER_MINUTE 60 |
||||||
|
#define MINS_PER_HOUR 60 |
||||||
|
|
||||||
|
#define USECS_PER_DAY INT64CONST(86400000000) |
||||||
|
#define USECS_PER_HOUR INT64CONST(3600000000) |
||||||
|
#define USECS_PER_MINUTE INT64CONST(60000000) |
||||||
|
#define USECS_PER_SEC INT64CONST(1000000) |
||||||
|
|
||||||
|
/*
|
||||||
|
* DT_NOBEGIN represents timestamp -infinity; DT_NOEND represents +infinity |
||||||
|
*/ |
||||||
|
#ifdef HAVE_INT64_TIMESTAMP |
||||||
|
#define DT_NOBEGIN (-INT64CONST(0x7fffffffffffffff) - 1) |
||||||
|
#define DT_NOEND (INT64CONST(0x7fffffffffffffff)) |
||||||
|
#else /* !HAVE_INT64_TIMESTAMP */ |
||||||
|
#ifdef HUGE_VAL |
||||||
|
#define DT_NOBEGIN (-HUGE_VAL) |
||||||
|
#define DT_NOEND (HUGE_VAL) |
||||||
|
#else |
||||||
|
#define DT_NOBEGIN (-DBL_MAX) |
||||||
|
#define DT_NOEND (DBL_MAX) |
||||||
|
#endif |
||||||
|
#endif /* HAVE_INT64_TIMESTAMP */ |
||||||
|
|
||||||
|
#define TIMESTAMP_NOBEGIN(j) \ |
||||||
|
do {(j) = DT_NOBEGIN;} while (0) |
||||||
|
|
||||||
|
#define TIMESTAMP_IS_NOBEGIN(j) ((j) == DT_NOBEGIN) |
||||||
|
|
||||||
|
#define TIMESTAMP_NOEND(j) \ |
||||||
|
do {(j) = DT_NOEND;} while (0) |
||||||
|
|
||||||
|
#define TIMESTAMP_IS_NOEND(j) ((j) == DT_NOEND) |
||||||
|
|
||||||
|
#define TIMESTAMP_NOT_FINITE(j) (TIMESTAMP_IS_NOBEGIN(j) || TIMESTAMP_IS_NOEND(j)) |
||||||
|
|
||||||
|
|
||||||
|
/*
|
||||||
|
* Julian date support. |
||||||
|
* |
||||||
|
* IS_VALID_JULIAN checks the minimum date exactly, but is a bit sloppy |
||||||
|
* about the maximum, since it's far enough out to not be especially |
||||||
|
* interesting. |
||||||
|
*/ |
||||||
|
|
||||||
|
#define JULIAN_MINYEAR (-4713) |
||||||
|
#define JULIAN_MINMONTH (11) |
||||||
|
#define JULIAN_MINDAY (24) |
||||||
|
#define JULIAN_MAXYEAR (5874898) |
||||||
|
|
||||||
|
#define IS_VALID_JULIAN(y,m,d) \ |
||||||
|
(((y) > JULIAN_MINYEAR \
|
||||||
|
|| ((y) == JULIAN_MINYEAR && \
|
||||||
|
((m) > JULIAN_MINMONTH \
|
||||||
|
|| ((m) == JULIAN_MINMONTH && (d) >= JULIAN_MINDAY)))) \
|
||||||
|
&& (y) < JULIAN_MAXYEAR) |
||||||
|
|
||||||
|
#define JULIAN_MAX (2147483494) /* == date2j(JULIAN_MAXYEAR, 1, 1) */ |
||||||
|
|
||||||
|
/* Julian-date equivalents of Day 0 in Unix and Postgres reckoning */ |
||||||
|
#define UNIX_EPOCH_JDATE 2440588 /* == date2j(1970, 1, 1) */ |
||||||
|
#define POSTGRES_EPOCH_JDATE 2451545 /* == date2j(2000, 1, 1) */ |
||||||
|
|
||||||
|
#endif /* DATATYPE_TIMESTAMP_H */ |
||||||
Loading…
Reference in new issue