date.h File Reference

#include <math.h>
#include "fmgr.h"

Include dependency graph for date.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	TimeTzADT

Macros
#define	DATEVAL_NOBEGIN   ((DateADT) PG_INT32_MIN)
#define	DATEVAL_NOEND   ((DateADT) PG_INT32_MAX)
#define	DATE_NOBEGIN(j)   ((j) = DATEVAL_NOBEGIN)
#define	DATE_IS_NOBEGIN(j)   ((j) == DATEVAL_NOBEGIN)
#define	DATE_NOEND(j)   ((j) = DATEVAL_NOEND)
#define	DATE_IS_NOEND(j)   ((j) == DATEVAL_NOEND)
#define	DATE_NOT_FINITE(j)   (DATE_IS_NOBEGIN(j) || DATE_IS_NOEND(j))
#define	MAX_TIME_PRECISION   6
#define	DatumGetDateADT(X)   ((DateADT) DatumGetInt32(X))
#define	DatumGetTimeADT(X)   ((TimeADT) DatumGetInt64(X))
#define	DatumGetTimeTzADTP(X)   ((TimeTzADT *) DatumGetPointer(X))
#define	DateADTGetDatum(X)   Int32GetDatum(X)
#define	TimeADTGetDatum(X)   Int64GetDatum(X)
#define	TimeTzADTPGetDatum(X)   PointerGetDatum(X)
#define	PG_GETARG_DATEADT(n)   DatumGetDateADT(PG_GETARG_DATUM(n))
#define	PG_GETARG_TIMEADT(n)   DatumGetTimeADT(PG_GETARG_DATUM(n))
#define	PG_GETARG_TIMETZADT_P(n)   DatumGetTimeTzADTP(PG_GETARG_DATUM(n))
#define	PG_RETURN_DATEADT(x)   return DateADTGetDatum(x)
#define	PG_RETURN_TIMEADT(x)   return TimeADTGetDatum(x)
#define	PG_RETURN_TIMETZADT_P(x)   return TimeTzADTPGetDatum(x)

Typedefs
typedef int32	DateADT
typedef int64	TimeADT

Functions
int32	anytime_typmod_check (bool istz, int32 typmod)
double	date2timestamp_no_overflow (DateADT dateVal)
void	EncodeSpecialDate (DateADT dt, char *str)
DateADT	GetSQLCurrentDate (void)
TimeTzADT *	GetSQLCurrentTime (int32 typmod)
TimeADT	GetSQLLocalTime (int32 typmod)

Macro Definition Documentation

#define DATE_IS_NOBEGIN

(

j

)

((j) == DATEVAL_NOBEGIN)

Definition at line 39 of file date.h.

Referenced by date2timestamp(), date2timestamp_no_overflow(), date2timestamptz(), datetimetz_timestamptz(), and EncodeSpecialDate().

#define DATE_IS_NOEND

(

j

)

((j) == DATEVAL_NOEND)

Definition at line 41 of file date.h.

Referenced by date2timestamp(), date2timestamp_no_overflow(), date2timestamptz(), datetimetz_timestamptz(), and EncodeSpecialDate().

#define DATE_NOBEGIN

(

j

)

((j) = DATEVAL_NOBEGIN)

Definition at line 38 of file date.h.

Referenced by abstime_date(), date_in(), timestamp_date(), and timestamptz_date().

#define DATE_NOEND

(

j

)

((j) = DATEVAL_NOEND)

Definition at line 40 of file date.h.

Referenced by abstime_date(), date_in(), timestamp_date(), and timestamptz_date().

#define DATE_NOT_FINITE

(

j

)

(DATE_IS_NOBEGIN(j) || DATE_IS_NOEND(j))

Definition at line 42 of file date.h.

Referenced by date_finite(), date_mi(), date_mii(), date_out(), date_pli(), date_recv(), datum_to_json(), datum_to_jsonb(), and map_sql_value_to_xml_value().

#define DateADTGetDatum

(

X

)

Int32GetDatum(X)

Definition at line 56 of file date.h.

Referenced by ExecEvalSQLValueFunction(), gbt_date_penalty(), gbt_dateeq(), gbt_datege(), gbt_dategt(), gbt_datekey_cmp(), gbt_datele(), gbt_datelt(), gbt_num_fetch(), gdb_date_dist(), and leftmostvalue_date().

#define DATEVAL_NOBEGIN   ((DateADT) PG_INT32_MIN)

Definition at line 35 of file date.h.

Referenced by leftmostvalue_date().

#define DATEVAL_NOEND   ((DateADT) PG_INT32_MAX)

Definition at line 36 of file date.h.

#define DatumGetDateADT

(

X

)

((DateADT) DatumGetInt32(X))

Definition at line 52 of file date.h.

Referenced by convert_timevalue_to_scalar(), date_fastcmp(), datum_to_json(), datum_to_jsonb(), gbt_num_compress(), and map_sql_value_to_xml_value().

#define DatumGetTimeADT

(

X

)

((TimeADT) DatumGetInt64(X))

Definition at line 53 of file date.h.

Referenced by convert_timevalue_to_scalar(), and gbt_num_compress().

#define DatumGetTimeTzADTP

(

X

)

((TimeTzADT *) DatumGetPointer(X))

Definition at line 54 of file date.h.

Referenced by convert_timevalue_to_scalar(), and gbt_timetz_compress().

#define MAX_TIME_PRECISION   6

Definition at line 50 of file date.h.

Referenced by AdjustTimeForTypmod(), anytime_typmod_check(), EncodeTimeOnly(), and time_transform().

#define PG_GETARG_DATEADT

(

n

)

DatumGetDateADT(PG_GETARG_DATUM(n))

Definition at line 60 of file date.h.

Referenced by date_cmp(), date_cmp_timestamp(), date_cmp_timestamptz(), date_eq(), date_eq_timestamp(), date_eq_timestamptz(), date_finite(), date_ge(), date_ge_timestamp(), date_ge_timestamptz(), date_gt(), date_gt_timestamp(), date_gt_timestamptz(), date_larger(), date_le(), date_le_timestamp(), date_le_timestamptz(), date_lt(), date_lt_timestamp(), date_lt_timestamptz(), date_mi(), date_mi_interval(), date_mii(), date_ne(), date_ne_timestamp(), date_ne_timestamptz(), date_out(), date_pl_interval(), date_pli(), date_send(), date_smaller(), date_timestamp(), date_timestamptz(), datetime_timestamp(), datetimetz_timestamptz(), gbt_date_consistent(), gbt_date_distance(), timestamp_cmp_date(), timestamp_eq_date(), timestamp_ge_date(), timestamp_gt_date(), timestamp_le_date(), timestamp_lt_date(), timestamp_ne_date(), timestamptz_cmp_date(), timestamptz_eq_date(), timestamptz_ge_date(), timestamptz_gt_date(), timestamptz_le_date(), timestamptz_lt_date(), and timestamptz_ne_date().

#define PG_GETARG_TIMEADT

(

n

)

DatumGetTimeADT(PG_GETARG_DATUM(n))

Definition at line 61 of file date.h.

Referenced by datetime_timestamp(), gbt_time_consistent(), gbt_time_distance(), time_cmp(), time_eq(), time_ge(), time_gt(), time_interval(), time_larger(), time_le(), time_lt(), time_mi_interval(), time_mi_time(), time_ne(), time_out(), time_part(), time_pl_interval(), time_scale(), time_send(), time_smaller(), and time_timetz().

#define PG_GETARG_TIMETZADT_P

(

n

)

DatumGetTimeTzADTP(PG_GETARG_DATUM(n))

Definition at line 62 of file date.h.

Referenced by datetimetz_timestamptz(), gbt_timetz_consistent(), timetz_cmp(), timetz_eq(), timetz_ge(), timetz_gt(), timetz_hash(), timetz_izone(), timetz_larger(), timetz_le(), timetz_lt(), timetz_mi_interval(), timetz_ne(), timetz_out(), timetz_part(), timetz_pl_interval(), timetz_scale(), timetz_send(), timetz_smaller(), timetz_time(), and timetz_zone().

#define PG_RETURN_DATEADT

(

x

)

return DateADTGetDatum(x)

Definition at line 64 of file date.h.

Referenced by abstime_date(), date_in(), date_larger(), date_mii(), date_pli(), date_recv(), date_smaller(), make_date(), timestamp_date(), timestamptz_date(), and to_date().

#define PG_RETURN_TIMEADT

(

x

)

return TimeADTGetDatum(x)

Definition at line 65 of file date.h.

Referenced by interval_time(), make_time(), time_in(), time_larger(), time_mi_interval(), time_pl_interval(), time_recv(), time_scale(), time_smaller(), timestamp_time(), timestamptz_time(), and timetz_time().

#define PG_RETURN_TIMETZADT_P

(

x

)

return TimeTzADTPGetDatum(x)

Definition at line 66 of file date.h.

Referenced by time_timetz(), timestamptz_timetz(), timetz_in(), timetz_izone(), timetz_larger(), timetz_mi_interval(), timetz_pl_interval(), timetz_recv(), timetz_scale(), timetz_smaller(), and timetz_zone().

#define TimeADTGetDatum

(

X

)

Int64GetDatum(X)

Definition at line 57 of file date.h.

Referenced by ExecEvalSQLValueFunction(), gbt_num_fetch(), and leftmostvalue_time().

#define TimeTzADTPGetDatum

(

X

)

PointerGetDatum(X)

Definition at line 58 of file date.h.

Referenced by ExecEvalSQLValueFunction(), and leftmostvalue_timetz().

Typedef Documentation

typedef int32 DateADT

Definition at line 22 of file date.h.

typedef int64 TimeADT

Definition at line 24 of file date.h.

Function Documentation

int32 anytime_typmod_check	(	bool	istz,
		int32	typmod
	)

Definition at line 74 of file date.c.

References ereport, errcode(), errmsg(), ERROR, MAX_TIME_PRECISION, and WARNING.

Referenced by anytime_typmodin(), and transformSQLValueFunction().

{
    if (typmod < 0)
        ereport(ERROR,
                (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                 errmsg("TIME(%d)%s precision must not be negative",
                        typmod, (istz ? " WITH TIME ZONE" : ""))));
    if (typmod > MAX_TIME_PRECISION)
    {
        ereport(WARNING,
                (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                 errmsg("TIME(%d)%s precision reduced to maximum allowed, %d",
                        typmod, (istz ? " WITH TIME ZONE" : ""),
                        MAX_TIME_PRECISION)));
        typmod = MAX_TIME_PRECISION;
    }

    return typmod;
}

double date2timestamp_no_overflow

(

DateADT

dateVal

)

Definition at line 658 of file date.c.

References DATE_IS_NOBEGIN, DATE_IS_NOEND, result, and USECS_PER_DAY.

Referenced by convert_timevalue_to_scalar().

{
    double      result;

    if (DATE_IS_NOBEGIN(dateVal))
        result = -DBL_MAX;
    else if (DATE_IS_NOEND(dateVal))
        result = DBL_MAX;
    else
    {
        /* date is days since 2000, timestamp is microseconds since same... */
        result = dateVal * (double) USECS_PER_DAY;
    }

    return result;
}

void EncodeSpecialDate	(	DateADT	dt,
		char *	str
	)

Definition at line 299 of file date.c.

References DATE_IS_NOBEGIN, DATE_IS_NOEND, EARLY, elog, ERROR, and LATE.

Referenced by date_out(), datum_to_json(), and datum_to_jsonb().

{
    if (DATE_IS_NOBEGIN(dt))
        strcpy(str, EARLY);
    else if (DATE_IS_NOEND(dt))
        strcpy(str, LATE);
    else                        /* shouldn't happen */
        elog(ERROR, "invalid argument for EncodeSpecialDate");
}

DateADT GetSQLCurrentDate

(

void

)

Definition at line 314 of file date.c.

References date2j(), ereport, errcode(), errmsg(), ERROR, GetCurrentTransactionStartTimestamp(), NULL, POSTGRES_EPOCH_JDATE, timestamp2tm(), tm, pg_tm::tm_mday, pg_tm::tm_mon, and pg_tm::tm_year.

Referenced by ExecEvalSQLValueFunction().

{
    TimestampTz ts;
    struct pg_tm tt,
               *tm = &tt;
    fsec_t      fsec;
    int         tz;

    ts = GetCurrentTransactionStartTimestamp();

    if (timestamp2tm(ts, &tz, tm, &fsec, NULL, NULL) != 0)
        ereport(ERROR,
                (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
                 errmsg("timestamp out of range")));

    return date2j(tm->tm_year, tm->tm_mon, tm->tm_mday) - POSTGRES_EPOCH_JDATE;
}

TimeTzADT* GetSQLCurrentTime

(

int32

typmod

)

Definition at line 336 of file date.c.

References AdjustTimeForTypmod(), ereport, errcode(), errmsg(), ERROR, GetCurrentTransactionStartTimestamp(), NULL, palloc(), result, TimeTzADT::time, timestamp2tm(), tm, and tm2timetz().

Referenced by ExecEvalSQLValueFunction().

{
    TimeTzADT  *result;
    TimestampTz ts;
    struct pg_tm tt,
               *tm = &tt;
    fsec_t      fsec;
    int         tz;

    ts = GetCurrentTransactionStartTimestamp();

    if (timestamp2tm(ts, &tz, tm, &fsec, NULL, NULL) != 0)
        ereport(ERROR,
                (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
                 errmsg("timestamp out of range")));

    result = (TimeTzADT *) palloc(sizeof(TimeTzADT));
    tm2timetz(tm, fsec, tz, result);
    AdjustTimeForTypmod(&(result->time), typmod);
    return result;
}

TimeADT GetSQLLocalTime

(

int32

typmod

)

Definition at line 362 of file date.c.

References AdjustTimeForTypmod(), ereport, errcode(), errmsg(), ERROR, GetCurrentTransactionStartTimestamp(), NULL, result, timestamp2tm(), tm, and tm2time().

Referenced by ExecEvalSQLValueFunction().

{
    TimeADT     result;
    TimestampTz ts;
    struct pg_tm tt,
               *tm = &tt;
    fsec_t      fsec;
    int         tz;

    ts = GetCurrentTransactionStartTimestamp();

    if (timestamp2tm(ts, &tz, tm, &fsec, NULL, NULL) != 0)
        ereport(ERROR,
                (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
                 errmsg("timestamp out of range")));

    tm2time(tm, fsec, &result);
    AdjustTimeForTypmod(&result, typmod);
    return result;
}