Header And Logo

PostgreSQL
| The world's most advanced open source database.

Data Structures | Defines | Typedefs | Functions | Variables

datetime.h File Reference

#include "nodes/nodes.h"
#include "utils/timestamp.h"
Include dependency graph for datetime.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  datetkn
struct  TimeZoneAbbrevTable

Defines

#define DAGO   "ago"
#define DCURRENT   "current"
#define EPOCH   "epoch"
#define INVALID   "invalid"
#define EARLY   "-infinity"
#define LATE   "infinity"
#define NOW   "now"
#define TODAY   "today"
#define TOMORROW   "tomorrow"
#define YESTERDAY   "yesterday"
#define ZULU   "zulu"
#define DMICROSEC   "usecond"
#define DMILLISEC   "msecond"
#define DSECOND   "second"
#define DMINUTE   "minute"
#define DHOUR   "hour"
#define DDAY   "day"
#define DWEEK   "week"
#define DMONTH   "month"
#define DQUARTER   "quarter"
#define DYEAR   "year"
#define DDECADE   "decade"
#define DCENTURY   "century"
#define DMILLENNIUM   "millennium"
#define DA_D   "ad"
#define DB_C   "bc"
#define DTIMEZONE   "timezone"
#define AM   0
#define PM   1
#define HR24   2
#define AD   0
#define BC   1
#define RESERV   0
#define MONTH   1
#define YEAR   2
#define DAY   3
#define JULIAN   4
#define TZ   5
#define DTZ   6
#define DTZMOD   7
#define IGNORE_DTF   8
#define AMPM   9
#define HOUR   10
#define MINUTE   11
#define SECOND   12
#define MILLISECOND   13
#define MICROSECOND   14
#define DOY   15
#define DOW   16
#define UNITS   17
#define ADBC   18
#define AGO   19
#define ABS_BEFORE   20
#define ABS_AFTER   21
#define ISODATE   22
#define ISOTIME   23
#define WEEK   24
#define DECADE   25
#define CENTURY   26
#define MILLENNIUM   27
#define UNKNOWN_FIELD   31
#define DTK_NUMBER   0
#define DTK_STRING   1
#define DTK_DATE   2
#define DTK_TIME   3
#define DTK_TZ   4
#define DTK_AGO   5
#define DTK_SPECIAL   6
#define DTK_INVALID   7
#define DTK_CURRENT   8
#define DTK_EARLY   9
#define DTK_LATE   10
#define DTK_EPOCH   11
#define DTK_NOW   12
#define DTK_YESTERDAY   13
#define DTK_TODAY   14
#define DTK_TOMORROW   15
#define DTK_ZULU   16
#define DTK_DELTA   17
#define DTK_SECOND   18
#define DTK_MINUTE   19
#define DTK_HOUR   20
#define DTK_DAY   21
#define DTK_WEEK   22
#define DTK_MONTH   23
#define DTK_QUARTER   24
#define DTK_YEAR   25
#define DTK_DECADE   26
#define DTK_CENTURY   27
#define DTK_MILLENNIUM   28
#define DTK_MILLISEC   29
#define DTK_MICROSEC   30
#define DTK_JULIAN   31
#define DTK_DOW   32
#define DTK_DOY   33
#define DTK_TZ_HOUR   34
#define DTK_TZ_MINUTE   35
#define DTK_ISOYEAR   36
#define DTK_ISODOW   37
#define DTK_M(t)   (0x01 << (t))
#define DTK_ALL_SECS_M   (DTK_M(SECOND) | DTK_M(MILLISECOND) | DTK_M(MICROSECOND))
#define DTK_DATE_M   (DTK_M(YEAR) | DTK_M(MONTH) | DTK_M(DAY))
#define DTK_TIME_M   (DTK_M(HOUR) | DTK_M(MINUTE) | DTK_ALL_SECS_M)
#define MAXDATELEN   63
#define MAXDATEFIELDS   25
#define TOKMAXLEN   10
#define FMODULO(t, q, u)
#define TMODULO(t, q, u)
#define isleap(y)   (((y) % 4) == 0 && (((y) % 100) != 0 || ((y) % 400) == 0))
#define DTERR_BAD_FORMAT   (-1)
#define DTERR_FIELD_OVERFLOW   (-2)
#define DTERR_MD_FIELD_OVERFLOW   (-3)
#define DTERR_INTERVAL_OVERFLOW   (-4)
#define DTERR_TZDISP_OVERFLOW   (-5)

Typedefs

typedef struct TimeZoneAbbrevTable TimeZoneAbbrevTable

Functions

void GetCurrentDateTime (struct pg_tm *tm)
void GetCurrentTimeUsec (struct pg_tm *tm, fsec_t *fsec, int *tzp)
void j2date (int jd, int *year, int *month, int *day)
int date2j (int year, int month, int day)
int ParseDateTime (const char *timestr, char *workbuf, size_t buflen, char **field, int *ftype, int maxfields, int *numfields)
int DecodeDateTime (char **field, int *ftype, int nf, int *dtype, struct pg_tm *tm, fsec_t *fsec, int *tzp)
int DecodeTimeOnly (char **field, int *ftype, int nf, int *dtype, struct pg_tm *tm, fsec_t *fsec, int *tzp)
int DecodeInterval (char **field, int *ftype, int nf, int range, int *dtype, struct pg_tm *tm, fsec_t *fsec)
int DecodeISO8601Interval (char *str, int *dtype, struct pg_tm *tm, fsec_t *fsec)
void DateTimeParseError (int dterr, const char *str, const char *datatype) __attribute__((noreturn))
int DetermineTimeZoneOffset (struct pg_tm *tm, pg_tz *tzp)
void EncodeDateOnly (struct pg_tm *tm, int style, char *str)
void EncodeTimeOnly (struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, int style, char *str)
void EncodeDateTime (struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, const char *tzn, int style, char *str)
void EncodeInterval (struct pg_tm *tm, fsec_t fsec, int style, char *str)
int DecodeSpecial (int field, char *lowtoken, int *val)
int DecodeUnits (int field, char *lowtoken, int *val)
int j2day (int jd)
NodeTemporalTransform (int32 max_precis, Node *node)
bool CheckDateTokenTables (void)
void ConvertTimeZoneAbbrevs (TimeZoneAbbrevTable *tbl, struct tzEntry *abbrevs, int n)
void InstallTimeZoneAbbrevs (TimeZoneAbbrevTable *tbl)
Datum pg_timezone_abbrevs (PG_FUNCTION_ARGS)
Datum pg_timezone_names (PG_FUNCTION_ARGS)

Variables

const int day_tab [2][13]

Define Documentation

#define ABS_AFTER   21

Definition at line 113 of file datetime.h.

#define ABS_BEFORE   20

Definition at line 112 of file datetime.h.

#define AD   0

Definition at line 76 of file datetime.h.

#define ADBC   18

Definition at line 109 of file datetime.h.

Referenced by DecodeDate(), DecodeDateTime(), and DecodeTimeOnly().

#define AGO   19

Definition at line 111 of file datetime.h.

Referenced by DecodeInterval().

#define AM   0

Definition at line 72 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define AMPM   9

Definition at line 100 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define BC   1

Definition at line 77 of file datetime.h.

#define CENTURY   26

Definition at line 120 of file datetime.h.

Referenced by DecodeInterval().

#define DA_D   "ad"

Definition at line 61 of file datetime.h.

#define DAGO   "ago"

Definition at line 36 of file datetime.h.

#define DAY   3
#define DB_C   "bc"

Definition at line 62 of file datetime.h.

#define DCENTURY   "century"

Definition at line 59 of file datetime.h.

#define DCURRENT   "current"

Definition at line 37 of file datetime.h.

#define DDAY   "day"

Definition at line 53 of file datetime.h.

#define DDECADE   "decade"

Definition at line 58 of file datetime.h.

#define DECADE   25

Definition at line 119 of file datetime.h.

Referenced by DecodeInterval().

#define DHOUR   "hour"

Definition at line 52 of file datetime.h.

#define DMICROSEC   "usecond"

Definition at line 48 of file datetime.h.

#define DMILLENNIUM   "millennium"

Definition at line 60 of file datetime.h.

#define DMILLISEC   "msecond"

Definition at line 49 of file datetime.h.

#define DMINUTE   "minute"

Definition at line 51 of file datetime.h.

#define DMONTH   "month"

Definition at line 55 of file datetime.h.

#define DOW   16

Definition at line 107 of file datetime.h.

Referenced by DecodeDateTime().

#define DOY   15

Definition at line 106 of file datetime.h.

Referenced by DecodeDate(), DecodeNumber(), and ValidateDate().

#define DQUARTER   "quarter"

Definition at line 56 of file datetime.h.

#define DSECOND   "second"

Definition at line 50 of file datetime.h.

#define DTERR_BAD_FORMAT   (-1)
#define DTERR_FIELD_OVERFLOW   (-2)

Definition at line 262 of file datetime.h.

Referenced by DateTimeParseError(), interval_in(), and reltimein().

#define DTERR_INTERVAL_OVERFLOW   (-4)

Definition at line 264 of file datetime.h.

Referenced by DateTimeParseError().

#define DTERR_MD_FIELD_OVERFLOW   (-3)

Definition at line 263 of file datetime.h.

Referenced by DateTimeParseError().

#define DTERR_TZDISP_OVERFLOW   (-5)

Definition at line 265 of file datetime.h.

Referenced by DateTimeParseError().

#define DTIMEZONE   "timezone"

Definition at line 63 of file datetime.h.

#define DTK_AGO   5

Definition at line 142 of file datetime.h.

#define DTK_ALL_SECS_M   (DTK_M(SECOND) | DTK_M(MILLISECOND) | DTK_M(MICROSECOND))

Definition at line 187 of file datetime.h.

#define DTK_CENTURY   27
#define DTK_CURRENT   8

Definition at line 146 of file datetime.h.

Referenced by date_in(), DecodeDateTime(), and DecodeTimeOnly().

#define DTK_DATE   2
#define DTK_DATE_M   (DTK_M(YEAR) | DTK_M(MONTH) | DTK_M(DAY))
#define DTK_DAY   21
#define DTK_DECADE   26
#define DTK_DELTA   17

Definition at line 156 of file datetime.h.

Referenced by interval_in(), PGTYPESinterval_from_asc(), and reltimein().

#define DTK_DOW   32

Definition at line 172 of file datetime.h.

Referenced by timestamp_part(), and timestamptz_part().

#define DTK_DOY   33

Definition at line 173 of file datetime.h.

Referenced by timestamp_part(), and timestamptz_part().

#define DTK_EARLY   9
#define DTK_EPOCH   11
#define DTK_HOUR   20
#define DTK_INVALID   7
#define DTK_ISODOW   37

Definition at line 177 of file datetime.h.

Referenced by timestamp_part(), and timestamptz_part().

#define DTK_ISOYEAR   36

Definition at line 176 of file datetime.h.

Referenced by time_part(), timestamp_part(), and timestamptz_part().

#define DTK_JULIAN   31

Definition at line 170 of file datetime.h.

Referenced by DecodeDateTime(), DecodeTimeOnly(), timestamp_part(), and timestamptz_part().

#define DTK_LATE   10
#define DTK_M (   t  )     (0x01 << (t))
#define DTK_MICROSEC   30
#define DTK_MILLENNIUM   28
#define DTK_MILLISEC   29
#define DTK_MINUTE   19
#define DTK_MONTH   23
#define DTK_NOW   12

Definition at line 150 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define DTK_NUMBER   0

Definition at line 136 of file datetime.h.

Referenced by DecodeDateTime(), DecodeInterval(), DecodeTimeOnly(), and ParseDateTime().

#define DTK_QUARTER   24
#define DTK_SECOND   18
#define DTK_SPECIAL   6

Definition at line 144 of file datetime.h.

Referenced by DecodeDateTime(), DecodeInterval(), and DecodeTimeOnly().

#define DTK_STRING   1

Definition at line 137 of file datetime.h.

Referenced by DecodeDateTime(), DecodeInterval(), and DecodeTimeOnly().

#define DTK_TIME   3

Definition at line 140 of file datetime.h.

Referenced by DecodeDateTime(), DecodeInterval(), and DecodeTimeOnly().

#define DTK_TIME_M   (DTK_M(HOUR) | DTK_M(MINUTE) | DTK_ALL_SECS_M)

Definition at line 189 of file datetime.h.

Referenced by DecodeDateTime(), DecodeNumberField(), and DecodeTimeOnly().

#define DTK_TODAY   14

Definition at line 152 of file datetime.h.

Referenced by DecodeDateTime().

#define DTK_TOMORROW   15

Definition at line 153 of file datetime.h.

Referenced by DecodeDateTime().

#define DTK_TZ   4
#define DTK_TZ_HOUR   34

Definition at line 174 of file datetime.h.

Referenced by time_part(), timestamp_part(), timestamptz_part(), and timetz_part().

#define DTK_TZ_MINUTE   35

Definition at line 175 of file datetime.h.

Referenced by time_part(), timestamp_part(), timestamptz_part(), and timetz_part().

#define DTK_WEEK   22
#define DTK_YEAR   25
#define DTK_YESTERDAY   13

Definition at line 151 of file datetime.h.

Referenced by DecodeDateTime().

#define DTK_ZULU   16

Definition at line 154 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define DTZ   6
#define DTZMOD   7

Definition at line 98 of file datetime.h.

Referenced by DecodeDateTime(), DecodeSpecial(), and DecodeTimeOnly().

#define DWEEK   "week"

Definition at line 54 of file datetime.h.

#define DYEAR   "year"

Definition at line 57 of file datetime.h.

#define EARLY   "-infinity"

Definition at line 40 of file datetime.h.

Referenced by abstimeout(), EncodeSpecialDate(), and EncodeSpecialTimestamp().

#define EPOCH   "epoch"

Definition at line 38 of file datetime.h.

#define FMODULO (   t,
  q,
  u 
)
Value:
do { \
    (q) = (((t) < 0) ? ceil((t) / (u)) : floor((t) / (u))); \
    if ((q) != 0) (t) -= rint((q) * (u)); \
} while(0)

Definition at line 220 of file datetime.h.

Referenced by reltime2tm(), timestamptz_part(), and timetz_part().

#define HOUR   10
#define HR24   2

Definition at line 74 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define IGNORE_DTF   8

Definition at line 99 of file datetime.h.

Referenced by DecodeDate(), DecodeDateTime(), DecodeInterval(), and DecodeTimeOnly().

#define INVALID   "invalid"

Definition at line 39 of file datetime.h.

#define isleap (   y  )     (((y) % 4) == 0 && (((y) % 100) != 0 || ((y) % 400) == 0))
#define ISODATE   22

Definition at line 115 of file datetime.h.

#define ISOTIME   23

Definition at line 116 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define JULIAN   4

Definition at line 95 of file datetime.h.

#define LATE   "infinity"

Definition at line 41 of file datetime.h.

Referenced by abstimeout(), EncodeSpecialDate(), and EncodeSpecialTimestamp().

#define MAXDATEFIELDS   25
#define MAXDATELEN   63
#define MICROSECOND   14

Definition at line 105 of file datetime.h.

Referenced by DecodeInterval().

#define MILLENNIUM   27

Definition at line 121 of file datetime.h.

Referenced by DecodeInterval().

#define MILLISECOND   13

Definition at line 104 of file datetime.h.

Referenced by DecodeInterval().

#define MINUTE   11
#define MONTH   1
#define NOW   "now"

Definition at line 42 of file datetime.h.

#define PM   1

Definition at line 73 of file datetime.h.

Referenced by DecodeDateTime(), and DecodeTimeOnly().

#define RESERV   0
#define SECOND   12
#define TMODULO (   t,
  q,
  u 
)
Value:
do { \
    (q) = (((t) < 0) ? ceil((t) / (u)) : floor((t) / (u))); \
    if ((q) != 0) (t) -= rint((q) * (u)); \
} while(0)

Definition at line 238 of file datetime.h.

Referenced by DecodeInterval(), interval2tm(), interval_justify_hours(), interval_justify_interval(), reltime_interval(), time2tm(), time_mi_interval(), time_pl_interval(), timestamp2tm(), timetz2tm(), timetz_mi_interval(), and timetz_pl_interval().

#define TODAY   "today"

Definition at line 43 of file datetime.h.

#define TOKMAXLEN   10
#define TOMORROW   "tomorrow"

Definition at line 44 of file datetime.h.

#define TZ   5
#define UNITS   17
#define UNKNOWN_FIELD   31
#define WEEK   24

Definition at line 118 of file datetime.h.

Referenced by DecodeInterval().

#define YEAR   2
#define YESTERDAY   "yesterday"

Definition at line 45 of file datetime.h.

#define ZULU   "zulu"

Definition at line 46 of file datetime.h.


Typedef Documentation


Function Documentation

bool CheckDateTokenTables ( void   ) 

Definition at line 4158 of file datetime.c.

{
    bool        ok = true;

    Assert(UNIX_EPOCH_JDATE == date2j(1970, 1, 1));
    Assert(POSTGRES_EPOCH_JDATE == date2j(2000, 1, 1));

    ok &= CheckDateTokenTable("datetktbl", datetktbl, szdatetktbl);
    ok &= CheckDateTokenTable("deltatktbl", deltatktbl, szdeltatktbl);
    return ok;
}

void ConvertTimeZoneAbbrevs ( TimeZoneAbbrevTable tbl,
struct tzEntry abbrevs,
int  n 
)

Definition at line 4212 of file datetime.c.

References TimeZoneAbbrevTable::abbrevs, Assert, CheckDateTokenTable(), DTZ, i, tzEntry::is_dst, MINS_PER_HOUR, TimeZoneAbbrevTable::numabbrevs, TOKMAXLEN, TOVAL, and datetkn::type.

Referenced by load_tzoffsets().

{
    datetkn    *newtbl = tbl->abbrevs;
    int         i;

    tbl->numabbrevs = n;
    for (i = 0; i < n; i++)
    {
        strncpy(newtbl[i].token, abbrevs[i].abbrev, TOKMAXLEN);
        newtbl[i].type = abbrevs[i].is_dst ? DTZ : TZ;
        TOVAL(&newtbl[i], abbrevs[i].offset / MINS_PER_HOUR);
    }

    /* Check the ordering, if testing */
    Assert(CheckDateTokenTable("timezone offset", newtbl, n));
}

int date2j ( int  year,
int  month,
int  day 
)

Definition at line 301 of file datetime.c.

{
    int         julian;
    int         century;

    if (m > 2)
    {
        m += 1;
        y += 4800;
    }
    else
    {
        m += 13;
        y += 4799;
    }

    century = y / 100;
    julian = y * 365 - 32167;
    julian += y / 4 - century + century / 4;
    julian += 7834 * m / 256 + d;

    return julian;
}   /* date2j() */

void DateTimeParseError ( int  dterr,
const char *  str,
const char *  datatype 
)

Definition at line 3537 of file datetime.c.

References DTERR_BAD_FORMAT, DTERR_FIELD_OVERFLOW, DTERR_INTERVAL_OVERFLOW, DTERR_MD_FIELD_OVERFLOW, DTERR_TZDISP_OVERFLOW, ereport, errcode(), errhint(), errmsg(), and ERROR.

Referenced by abstimein(), date_in(), interval_in(), reltimein(), time_in(), timestamp_in(), timestamptz_in(), and timetz_in().

{
    switch (dterr)
    {
        case DTERR_FIELD_OVERFLOW:
            ereport(ERROR,
                    (errcode(ERRCODE_DATETIME_FIELD_OVERFLOW),
                     errmsg("date/time field value out of range: \"%s\"",
                            str)));
            break;
        case DTERR_MD_FIELD_OVERFLOW:
            /* <nanny>same as above, but add hint about DateStyle</nanny> */
            ereport(ERROR,
                    (errcode(ERRCODE_DATETIME_FIELD_OVERFLOW),
                     errmsg("date/time field value out of range: \"%s\"",
                            str),
            errhint("Perhaps you need a different \"datestyle\" setting.")));
            break;
        case DTERR_INTERVAL_OVERFLOW:
            ereport(ERROR,
                    (errcode(ERRCODE_INTERVAL_FIELD_OVERFLOW),
                     errmsg("interval field value out of range: \"%s\"",
                            str)));
            break;
        case DTERR_TZDISP_OVERFLOW:
            ereport(ERROR,
                    (errcode(ERRCODE_INVALID_TIME_ZONE_DISPLACEMENT_VALUE),
                     errmsg("time zone displacement out of range: \"%s\"",
                            str)));
            break;
        case DTERR_BAD_FORMAT:
        default:
            ereport(ERROR,
                    (errcode(ERRCODE_INVALID_DATETIME_FORMAT),
                     errmsg("invalid input syntax for type %s: \"%s\"",
                            datatype, str)));
            break;
    }
}

int DecodeDateTime ( char **  field,
int *  ftype,
int  nf,
int *  dtype,
struct pg_tm tm,
fsec_t fsec,
int *  tzp 
)

Definition at line 788 of file datetime.c.

References ADBC, AM, AMPM, date2j(), DAY, DecodeDate(), DecodeNumber(), DecodeNumberField(), DecodeSpecial(), DecodeTime(), DecodeTimezone(), DetermineTimeZoneOffset(), DOW, dt2time(), DTERR_BAD_FORMAT, DTK_CURRENT, DTK_DATE, DTK_DATE_M, DTK_DAY, DTK_HOUR, DTK_JULIAN, DTK_M, DTK_MINUTE, DTK_MONTH, DTK_NOW, DTK_NUMBER, DTK_SECOND, DTK_SPECIAL, DTK_STRING, DTK_TIME, DTK_TIME_M, DTK_TODAY, DTK_TOMORROW, DTK_TZ, DTK_YEAR, DTK_YESTERDAY, DTK_ZULU, DTZ, DTZMOD, ereport, errcode(), errmsg(), ERROR, GetCurrentDateTime(), GetCurrentTimeUsec(), HOUR, HOURS_PER_DAY, HR24, i, IGNORE_DTF, INTERVAL_FULL_RANGE, ISOTIME, j2date(), MINUTE, MONTH, NULL, ParseFractionalSecond(), pg_tzset(), PM, RESERV, SECOND, session_timezone, strtoi(), pg_tm::tm_hour, pg_tm::tm_isdst, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_wday, pg_tm::tm_year, TZ, UNITS, UNKNOWN_FIELD, val, ValidateDate(), and YEAR.

Referenced by abstimein(), date_in(), pg_logdir_ls(), PGTYPESdate_from_asc(), PGTYPEStimestamp_from_asc(), timestamp_in(), and timestamptz_in().

{
    int         fmask = 0,
                tmask,
                type;
    int         ptype = 0;      /* "prefix type" for ISO y2001m02d04 format */
    int         i;
    int         val;
    int         dterr;
    int         mer = HR24;
    bool        haveTextMonth = FALSE;
    bool        isjulian = FALSE;
    bool        is2digits = FALSE;
    bool        bc = FALSE;
    pg_tz      *namedTz = NULL;
    struct pg_tm cur_tm;

    /*
     * We'll insist on at least all of the date fields, but initialize the
     * remaining fields in case they are not set later...
     */
    *dtype = DTK_DATE;
    tm->tm_hour = 0;
    tm->tm_min = 0;
    tm->tm_sec = 0;
    *fsec = 0;
    /* don't know daylight savings time status apriori */
    tm->tm_isdst = -1;
    if (tzp != NULL)
        *tzp = 0;

    for (i = 0; i < nf; i++)
    {
        switch (ftype[i])
        {
            case DTK_DATE:
                /***
                 * Integral julian day with attached time zone?
                 * All other forms with JD will be separated into
                 * distinct fields, so we handle just this case here.
                 ***/
                if (ptype == DTK_JULIAN)
                {
                    char       *cp;
                    int         val;

                    if (tzp == NULL)
                        return DTERR_BAD_FORMAT;

                    errno = 0;
                    val = strtoi(field[i], &cp, 10);
                    if (errno == ERANGE || val < 0)
                        return DTERR_FIELD_OVERFLOW;

                    j2date(val, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
                    isjulian = TRUE;

                    /* Get the time zone from the end of the string */
                    dterr = DecodeTimezone(cp, tzp);
                    if (dterr)
                        return dterr;

                    tmask = DTK_DATE_M | DTK_TIME_M | DTK_M(TZ);
                    ptype = 0;
                    break;
                }
                /***
                 * Already have a date? Then this might be a time zone name
                 * with embedded punctuation (e.g. "America/New_York") or a
                 * run-together time with trailing time zone (e.g. hhmmss-zz).
                 * - thomas 2001-12-25
                 *
                 * We consider it a time zone if we already have month & day.
                 * This is to allow the form "mmm dd hhmmss tz year", which
                 * we've historically accepted.
                 ***/
                else if (ptype != 0 ||
                         ((fmask & (DTK_M(MONTH) | DTK_M(DAY))) ==
                          (DTK_M(MONTH) | DTK_M(DAY))))
                {
                    /* No time zone accepted? Then quit... */
                    if (tzp == NULL)
                        return DTERR_BAD_FORMAT;

                    if (isdigit((unsigned char) *field[i]) || ptype != 0)
                    {
                        char       *cp;

                        if (ptype != 0)
                        {
                            /* Sanity check; should not fail this test */
                            if (ptype != DTK_TIME)
                                return DTERR_BAD_FORMAT;
                            ptype = 0;
                        }

                        /*
                         * Starts with a digit but we already have a time
                         * field? Then we are in trouble with a date and time
                         * already...
                         */
                        if ((fmask & DTK_TIME_M) == DTK_TIME_M)
                            return DTERR_BAD_FORMAT;

                        if ((cp = strchr(field[i], '-')) == NULL)
                            return DTERR_BAD_FORMAT;

                        /* Get the time zone from the end of the string */
                        dterr = DecodeTimezone(cp, tzp);
                        if (dterr)
                            return dterr;
                        *cp = '\0';

                        /*
                         * Then read the rest of the field as a concatenated
                         * time
                         */
                        dterr = DecodeNumberField(strlen(field[i]), field[i],
                                                  fmask,
                                                  &tmask, tm,
                                                  fsec, &is2digits);
                        if (dterr < 0)
                            return dterr;

                        /*
                         * modify tmask after returning from
                         * DecodeNumberField()
                         */
                        tmask |= DTK_M(TZ);
                    }
                    else
                    {
                        namedTz = pg_tzset(field[i]);
                        if (!namedTz)
                        {
                            /*
                             * We should return an error code instead of
                             * ereport'ing directly, but then there is no way
                             * to report the bad time zone name.
                             */
                            ereport(ERROR,
                                    (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                                     errmsg("time zone \"%s\" not recognized",
                                            field[i])));
                        }
                        /* we'll apply the zone setting below */
                        tmask = DTK_M(TZ);
                    }
                }
                else
                {
                    dterr = DecodeDate(field[i], fmask,
                                       &tmask, &is2digits, tm);
                    if (dterr)
                        return dterr;
                }
                break;

            case DTK_TIME:
                /*
                 * This might be an ISO time following a "t" field.
                 */
                if (ptype != 0)
                {
                    /* Sanity check; should not fail this test */
                    if (ptype != DTK_TIME)
                        return DTERR_BAD_FORMAT;
                    ptype = 0;
                }
                dterr = DecodeTime(field[i], fmask, INTERVAL_FULL_RANGE,
                                   &tmask, tm, fsec);
                if (dterr)
                    return dterr;

                /*
                 * Check upper limit on hours; other limits checked in
                 * DecodeTime()
                 */
                /* test for > 24:00:00 */
                if (tm->tm_hour > HOURS_PER_DAY ||
                    (tm->tm_hour == HOURS_PER_DAY &&
                     (tm->tm_min > 0 || tm->tm_sec > 0 || *fsec > 0)))
                    return DTERR_FIELD_OVERFLOW;
                break;

            case DTK_TZ:
                {
                    int         tz;

                    if (tzp == NULL)
                        return DTERR_BAD_FORMAT;

                    dterr = DecodeTimezone(field[i], &tz);
                    if (dterr)
                        return dterr;
                    *tzp = tz;
                    tmask = DTK_M(TZ);
                }
                break;

            case DTK_NUMBER:

                /*
                 * Was this an "ISO date" with embedded field labels? An
                 * example is "y2001m02d04" - thomas 2001-02-04
                 */
                if (ptype != 0)
                {
                    char       *cp;
                    int         val;

                    errno = 0;
                    val = strtoi(field[i], &cp, 10);
                    if (errno == ERANGE)
                        return DTERR_FIELD_OVERFLOW;

                    /*
                     * only a few kinds are allowed to have an embedded
                     * decimal
                     */
                    if (*cp == '.')
                        switch (ptype)
                        {
                            case DTK_JULIAN:
                            case DTK_TIME:
                            case DTK_SECOND:
                                break;
                            default:
                                return DTERR_BAD_FORMAT;
                                break;
                        }
                    else if (*cp != '\0')
                        return DTERR_BAD_FORMAT;

                    switch (ptype)
                    {
                        case DTK_YEAR:
                            tm->tm_year = val;
                            tmask = DTK_M(YEAR);
                            break;

                        case DTK_MONTH:

                            /*
                             * already have a month and hour? then assume
                             * minutes
                             */
                            if ((fmask & DTK_M(MONTH)) != 0 &&
                                (fmask & DTK_M(HOUR)) != 0)
                            {
                                tm->tm_min = val;
                                tmask = DTK_M(MINUTE);
                            }
                            else
                            {
                                tm->tm_mon = val;
                                tmask = DTK_M(MONTH);
                            }
                            break;

                        case DTK_DAY:
                            tm->tm_mday = val;
                            tmask = DTK_M(DAY);
                            break;

                        case DTK_HOUR:
                            tm->tm_hour = val;
                            tmask = DTK_M(HOUR);
                            break;

                        case DTK_MINUTE:
                            tm->tm_min = val;
                            tmask = DTK_M(MINUTE);
                            break;

                        case DTK_SECOND:
                            tm->tm_sec = val;
                            tmask = DTK_M(SECOND);
                            if (*cp == '.')
                            {
                                dterr = ParseFractionalSecond(cp, fsec);
                                if (dterr)
                                    return dterr;
                                tmask = DTK_ALL_SECS_M;
                            }
                            break;

                        case DTK_TZ:
                            tmask = DTK_M(TZ);
                            dterr = DecodeTimezone(field[i], tzp);
                            if (dterr)
                                return dterr;
                            break;

                        case DTK_JULIAN:
                            /* previous field was a label for "julian date" */
                            if (val < 0)
                                return DTERR_FIELD_OVERFLOW;
                            tmask = DTK_DATE_M;
                            j2date(val, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
                            isjulian = TRUE;

                            /* fractional Julian Day? */
                            if (*cp == '.')
                            {
                                double      time;

                                errno = 0;
                                time = strtod(cp, &cp);
                                if (*cp != '\0' || errno != 0)
                                    return DTERR_BAD_FORMAT;

#ifdef HAVE_INT64_TIMESTAMP
                                time *= USECS_PER_DAY;
#else
                                time *= SECS_PER_DAY;
#endif
                                dt2time(time,
                                        &tm->tm_hour, &tm->tm_min,
                                        &tm->tm_sec, fsec);
                                tmask |= DTK_TIME_M;
                            }
                            break;

                        case DTK_TIME:
                            /* previous field was "t" for ISO time */
                            dterr = DecodeNumberField(strlen(field[i]), field[i],
                                                      (fmask | DTK_DATE_M),
                                                      &tmask, tm,
                                                      fsec, &is2digits);
                            if (dterr < 0)
                                return dterr;
                            if (tmask != DTK_TIME_M)
                                return DTERR_BAD_FORMAT;
                            break;

                        default:
                            return DTERR_BAD_FORMAT;
                            break;
                    }

                    ptype = 0;
                    *dtype = DTK_DATE;
                }
                else
                {
                    char       *cp;
                    int         flen;

                    flen = strlen(field[i]);
                    cp = strchr(field[i], '.');

                    /* Embedded decimal and no date yet? */
                    if (cp != NULL && !(fmask & DTK_DATE_M))
                    {
                        dterr = DecodeDate(field[i], fmask,
                                           &tmask, &is2digits, tm);
                        if (dterr)
                            return dterr;
                    }
                    /* embedded decimal and several digits before? */
                    else if (cp != NULL && flen - strlen(cp) > 2)
                    {
                        /*
                         * Interpret as a concatenated date or time Set the
                         * type field to allow decoding other fields later.
                         * Example: 20011223 or 040506
                         */
                        dterr = DecodeNumberField(flen, field[i], fmask,
                                                  &tmask, tm,
                                                  fsec, &is2digits);
                        if (dterr < 0)
                            return dterr;
                    }
                    else if (flen > 4)
                    {
                        dterr = DecodeNumberField(flen, field[i], fmask,
                                                  &tmask, tm,
                                                  fsec, &is2digits);
                        if (dterr < 0)
                            return dterr;
                    }
                    /* otherwise it is a single date/time field... */
                    else
                    {
                        dterr = DecodeNumber(flen, field[i],
                                             haveTextMonth, fmask,
                                             &tmask, tm,
                                             fsec, &is2digits);
                        if (dterr)
                            return dterr;
                    }
                }
                break;

            case DTK_STRING:
            case DTK_SPECIAL:
                type = DecodeSpecial(i, field[i], &val);
                if (type == IGNORE_DTF)
                    continue;

                tmask = DTK_M(type);
                switch (type)
                {
                    case RESERV:
                        switch (val)
                        {
                            case DTK_CURRENT:
                                ereport(ERROR,
                                     (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
                                      errmsg("date/time value \"current\" is no longer supported")));

                                return DTERR_BAD_FORMAT;
                                break;

                            case DTK_NOW:
                                tmask = (DTK_DATE_M | DTK_TIME_M | DTK_M(TZ));
                                *dtype = DTK_DATE;
                                GetCurrentTimeUsec(tm, fsec, tzp);
                                break;

                            case DTK_YESTERDAY:
                                tmask = DTK_DATE_M;
                                *dtype = DTK_DATE;
                                GetCurrentDateTime(&cur_tm);
                                j2date(date2j(cur_tm.tm_year, cur_tm.tm_mon, cur_tm.tm_mday) - 1,
                                    &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
                                break;

                            case DTK_TODAY:
                                tmask = DTK_DATE_M;
                                *dtype = DTK_DATE;
                                GetCurrentDateTime(&cur_tm);
                                tm->tm_year = cur_tm.tm_year;
                                tm->tm_mon = cur_tm.tm_mon;
                                tm->tm_mday = cur_tm.tm_mday;
                                break;

                            case DTK_TOMORROW:
                                tmask = DTK_DATE_M;
                                *dtype = DTK_DATE;
                                GetCurrentDateTime(&cur_tm);
                                j2date(date2j(cur_tm.tm_year, cur_tm.tm_mon, cur_tm.tm_mday) + 1,
                                    &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
                                break;

                            case DTK_ZULU:
                                tmask = (DTK_TIME_M | DTK_M(TZ));
                                *dtype = DTK_DATE;
                                tm->tm_hour = 0;
                                tm->tm_min = 0;
                                tm->tm_sec = 0;
                                if (tzp != NULL)
                                    *tzp = 0;
                                break;

                            default:
                                *dtype = val;
                        }

                        break;

                    case MONTH:

                        /*
                         * already have a (numeric) month? then see if we can
                         * substitute...
                         */
                        if ((fmask & DTK_M(MONTH)) && !haveTextMonth &&
                            !(fmask & DTK_M(DAY)) && tm->tm_mon >= 1 &&
                            tm->tm_mon <= 31)
                        {
                            tm->tm_mday = tm->tm_mon;
                            tmask = DTK_M(DAY);
                        }
                        haveTextMonth = TRUE;
                        tm->tm_mon = val;
                        break;

                    case DTZMOD:

                        /*
                         * daylight savings time modifier (solves "MET DST"
                         * syntax)
                         */
                        tmask |= DTK_M(DTZ);
                        tm->tm_isdst = 1;
                        if (tzp == NULL)
                            return DTERR_BAD_FORMAT;
                        *tzp += val * MINS_PER_HOUR;
                        break;

                    case DTZ:

                        /*
                         * set mask for TZ here _or_ check for DTZ later when
                         * getting default timezone
                         */
                        tmask |= DTK_M(TZ);
                        tm->tm_isdst = 1;
                        if (tzp == NULL)
                            return DTERR_BAD_FORMAT;
                        *tzp = val * MINS_PER_HOUR;
                        break;

                    case TZ:
                        tm->tm_isdst = 0;
                        if (tzp == NULL)
                            return DTERR_BAD_FORMAT;
                        *tzp = val * MINS_PER_HOUR;
                        break;

                    case IGNORE_DTF:
                        break;

                    case AMPM:
                        mer = val;
                        break;

                    case ADBC:
                        bc = (val == BC);
                        break;

                    case DOW:
                        tm->tm_wday = val;
                        break;

                    case UNITS:
                        tmask = 0;
                        ptype = val;
                        break;

                    case ISOTIME:

                        /*
                         * This is a filler field "t" indicating that the next
                         * field is time. Try to verify that this is sensible.
                         */
                        tmask = 0;

                        /* No preceding date? Then quit... */
                        if ((fmask & DTK_DATE_M) != DTK_DATE_M)
                            return DTERR_BAD_FORMAT;

                        /***
                         * We will need one of the following fields:
                         *  DTK_NUMBER should be hhmmss.fff
                         *  DTK_TIME should be hh:mm:ss.fff
                         *  DTK_DATE should be hhmmss-zz
                         ***/
                        if (i >= nf - 1 ||
                            (ftype[i + 1] != DTK_NUMBER &&
                             ftype[i + 1] != DTK_TIME &&
                             ftype[i + 1] != DTK_DATE))
                            return DTERR_BAD_FORMAT;

                        ptype = val;
                        break;

                    case UNKNOWN_FIELD:

                        /*
                         * Before giving up and declaring error, check to see
                         * if it is an all-alpha timezone name.
                         */
                        namedTz = pg_tzset(field[i]);
                        if (!namedTz)
                            return DTERR_BAD_FORMAT;
                        /* we'll apply the zone setting below */
                        tmask = DTK_M(TZ);
                        break;

                    default:
                        return DTERR_BAD_FORMAT;
                }
                break;

            default:
                return DTERR_BAD_FORMAT;
        }

        if (tmask & fmask)
            return DTERR_BAD_FORMAT;
        fmask |= tmask;
    }                           /* end loop over fields */

    /* do final checking/adjustment of Y/M/D fields */
    dterr = ValidateDate(fmask, isjulian, is2digits, bc, tm);
    if (dterr)
        return dterr;

    /* handle AM/PM */
    if (mer != HR24 && tm->tm_hour > HOURS_PER_DAY / 2)
        return DTERR_FIELD_OVERFLOW;
    if (mer == AM && tm->tm_hour == HOURS_PER_DAY / 2)
        tm->tm_hour = 0;
    else if (mer == PM && tm->tm_hour != HOURS_PER_DAY / 2)
        tm->tm_hour += HOURS_PER_DAY / 2;

    /* do additional checking for full date specs... */
    if (*dtype == DTK_DATE)
    {
        if ((fmask & DTK_DATE_M) != DTK_DATE_M)
        {
            if ((fmask & DTK_TIME_M) == DTK_TIME_M)
                return 1;
            return DTERR_BAD_FORMAT;
        }

        /*
         * If we had a full timezone spec, compute the offset (we could not do
         * it before, because we need the date to resolve DST status).
         */
        if (namedTz != NULL)
        {
            /* daylight savings time modifier disallowed with full TZ */
            if (fmask & DTK_M(DTZMOD))
                return DTERR_BAD_FORMAT;

            *tzp = DetermineTimeZoneOffset(tm, namedTz);
        }

        /* timezone not specified? then find local timezone if possible */
        if (tzp != NULL && !(fmask & DTK_M(TZ)))
        {
            /*
             * daylight savings time modifier but no standard timezone? then
             * error
             */
            if (fmask & DTK_M(DTZMOD))
                return DTERR_BAD_FORMAT;

            *tzp = DetermineTimeZoneOffset(tm, session_timezone);
        }
    }

    return 0;
}

int DecodeInterval ( char **  field,
int *  ftype,
int  nf,
int  range,
int *  dtype,
struct pg_tm tm,
fsec_t fsec 
)

Definition at line 2857 of file datetime.c.

References AdjustFractDays(), AdjustFractSeconds(), AGO, Assert, CENTURY, ClearPgTm(), DAY, DAYS_PER_MONTH, DECADE, DecodeTime(), DecodeUnits(), DTK_CENTURY, DTK_DATE, DTK_DATE_M, DTK_DAY, DTK_DECADE, DTK_HOUR, DTK_M, DTK_MICROSEC, DTK_MILLENNIUM, DTK_MILLISEC, DTK_MINUTE, DTK_MONTH, DTK_NUMBER, DTK_SECOND, DTK_SPECIAL, DTK_STRING, DTK_TIME, DTK_TZ, DTK_WEEK, DTK_YEAR, HOUR, i, IGNORE_DTF, INTERVAL_MASK, IntervalStyle, INTSTYLE_SQL_STANDARD, MICROSECOND, MILLENNIUM, MILLISECOND, MINUTE, MONTH, MONTHS_PER_YEAR, NULL, RESERV, rint(), SECOND, SECS_PER_DAY, SECS_PER_HOUR, SECS_PER_MINUTE, strtoi(), pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, TMODULO, UNITS, val, WEEK, and YEAR.

Referenced by interval_in(), PGTYPESinterval_from_asc(), and reltimein().

{
    bool        is_before = FALSE;
    char       *cp;
    int         fmask = 0,
                tmask,
                type;
    int         i;
    int         dterr;
    int         val;
    double      fval;

    *dtype = DTK_DELTA;
    type = IGNORE_DTF;
    ClearPgTm(tm, fsec);

    /* read through list backwards to pick up units before values */
    for (i = nf - 1; i >= 0; i--)
    {
        switch (ftype[i])
        {
            case DTK_TIME:
                dterr = DecodeTime(field[i], fmask, range,
                                   &tmask, tm, fsec);
                if (dterr)
                    return dterr;
                type = DTK_DAY;
                break;

            case DTK_TZ:

                /*
                 * Timezone means a token with a leading sign character and at
                 * least one digit; there could be ':', '.', '-' embedded in
                 * it as well.
                 */
                Assert(*field[i] == '-' || *field[i] == '+');

                /*
                 * Check for signed hh:mm or hh:mm:ss.  If so, process exactly
                 * like DTK_TIME case above, plus handling the sign.
                 */
                if (strchr(field[i] + 1, ':') != NULL &&
                    DecodeTime(field[i] + 1, fmask, range,
                               &tmask, tm, fsec) == 0)
                {
                    if (*field[i] == '-')
                    {
                        /* flip the sign on all fields */
                        tm->tm_hour = -tm->tm_hour;
                        tm->tm_min = -tm->tm_min;
                        tm->tm_sec = -tm->tm_sec;
                        *fsec = -(*fsec);
                    }

                    /*
                     * Set the next type to be a day, if units are not
                     * specified. This handles the case of '1 +02:03' since we
                     * are reading right to left.
                     */
                    type = DTK_DAY;
                    break;
                }

                /*
                 * Otherwise, fall through to DTK_NUMBER case, which can
                 * handle signed float numbers and signed year-month values.
                 */

                /* FALL THROUGH */

            case DTK_DATE:
            case DTK_NUMBER:
                if (type == IGNORE_DTF)
                {
                    /* use typmod to decide what rightmost field is */
                    switch (range)
                    {
                        case INTERVAL_MASK(YEAR):
                            type = DTK_YEAR;
                            break;
                        case INTERVAL_MASK(MONTH):
                        case INTERVAL_MASK(YEAR) | INTERVAL_MASK(MONTH):
                            type = DTK_MONTH;
                            break;
                        case INTERVAL_MASK(DAY):
                            type = DTK_DAY;
                            break;
                        case INTERVAL_MASK(HOUR):
                        case INTERVAL_MASK(DAY) | INTERVAL_MASK(HOUR):
                            type = DTK_HOUR;
                            break;
                        case INTERVAL_MASK(MINUTE):
                        case INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE):
                        case INTERVAL_MASK(DAY) | INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE):
                            type = DTK_MINUTE;
                            break;
                        case INTERVAL_MASK(SECOND):
                        case INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND):
                        case INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND):
                        case INTERVAL_MASK(DAY) | INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND):
                            type = DTK_SECOND;
                            break;
                        default:
                            type = DTK_SECOND;
                            break;
                    }
                }

                errno = 0;
                val = strtoi(field[i], &cp, 10);
                if (errno == ERANGE)
                    return DTERR_FIELD_OVERFLOW;

                if (*cp == '-')
                {
                    /* SQL "years-months" syntax */
                    int         val2;

                    val2 = strtoi(cp + 1, &cp, 10);
                    if (errno == ERANGE || val2 < 0 || val2 >= MONTHS_PER_YEAR)
                        return DTERR_FIELD_OVERFLOW;
                    if (*cp != '\0')
                        return DTERR_BAD_FORMAT;
                    type = DTK_MONTH;
                    if (*field[i] == '-')
                        val2 = -val2;
                    val = val * MONTHS_PER_YEAR + val2;
                    fval = 0;
                }
                else if (*cp == '.')
                {
                    errno = 0;
                    fval = strtod(cp, &cp);
                    if (*cp != '\0' || errno != 0)
                        return DTERR_BAD_FORMAT;

                    if (*field[i] == '-')
                        fval = -fval;
                }
                else if (*cp == '\0')
                    fval = 0;
                else
                    return DTERR_BAD_FORMAT;

                tmask = 0;      /* DTK_M(type); */

                switch (type)
                {
                    case DTK_MICROSEC:
#ifdef HAVE_INT64_TIMESTAMP
                        *fsec += rint(val + fval);
#else
                        *fsec += (val + fval) * 1e-6;
#endif
                        tmask = DTK_M(MICROSECOND);
                        break;

                    case DTK_MILLISEC:
                        /* avoid overflowing the fsec field */
                        tm->tm_sec += val / 1000;
                        val -= (val / 1000) * 1000;
#ifdef HAVE_INT64_TIMESTAMP
                        *fsec += rint((val + fval) * 1000);
#else
                        *fsec += (val + fval) * 1e-3;
#endif
                        tmask = DTK_M(MILLISECOND);
                        break;

                    case DTK_SECOND:
                        tm->tm_sec += val;
#ifdef HAVE_INT64_TIMESTAMP
                        *fsec += rint(fval * 1000000);
#else
                        *fsec += fval;
#endif

                        /*
                         * If any subseconds were specified, consider this
                         * microsecond and millisecond input as well.
                         */
                        if (fval == 0)
                            tmask = DTK_M(SECOND);
                        else
                            tmask = DTK_ALL_SECS_M;
                        break;

                    case DTK_MINUTE:
                        tm->tm_min += val;
                        AdjustFractSeconds(fval, tm, fsec, SECS_PER_MINUTE);
                        tmask = DTK_M(MINUTE);
                        break;

                    case DTK_HOUR:
                        tm->tm_hour += val;
                        AdjustFractSeconds(fval, tm, fsec, SECS_PER_HOUR);
                        tmask = DTK_M(HOUR);
                        type = DTK_DAY; /* set for next field */
                        break;

                    case DTK_DAY:
                        tm->tm_mday += val;
                        AdjustFractSeconds(fval, tm, fsec, SECS_PER_DAY);
                        tmask = DTK_M(DAY);
                        break;

                    case DTK_WEEK:
                        tm->tm_mday += val * 7;
                        AdjustFractDays(fval, tm, fsec, 7);
                        tmask = DTK_M(WEEK);
                        break;

                    case DTK_MONTH:
                        tm->tm_mon += val;
                        AdjustFractDays(fval, tm, fsec, DAYS_PER_MONTH);
                        tmask = DTK_M(MONTH);
                        break;

                    case DTK_YEAR:
                        tm->tm_year += val;
                        if (fval != 0)
                            tm->tm_mon += fval * MONTHS_PER_YEAR;
                        tmask = DTK_M(YEAR);
                        break;

                    case DTK_DECADE:
                        tm->tm_year += val * 10;
                        if (fval != 0)
                            tm->tm_mon += fval * MONTHS_PER_YEAR * 10;
                        tmask = DTK_M(DECADE);
                        break;

                    case DTK_CENTURY:
                        tm->tm_year += val * 100;
                        if (fval != 0)
                            tm->tm_mon += fval * MONTHS_PER_YEAR * 100;
                        tmask = DTK_M(CENTURY);
                        break;

                    case DTK_MILLENNIUM:
                        tm->tm_year += val * 1000;
                        if (fval != 0)
                            tm->tm_mon += fval * MONTHS_PER_YEAR * 1000;
                        tmask = DTK_M(MILLENNIUM);
                        break;

                    default:
                        return DTERR_BAD_FORMAT;
                }
                break;

            case DTK_STRING:
            case DTK_SPECIAL:
                type = DecodeUnits(i, field[i], &val);
                if (type == IGNORE_DTF)
                    continue;

                tmask = 0;      /* DTK_M(type); */
                switch (type)
                {
                    case UNITS:
                        type = val;
                        break;

                    case AGO:
                        is_before = TRUE;
                        type = val;
                        break;

                    case RESERV:
                        tmask = (DTK_DATE_M | DTK_TIME_M);
                        *dtype = val;
                        break;

                    default:
                        return DTERR_BAD_FORMAT;
                }
                break;

            default:
                return DTERR_BAD_FORMAT;
        }

        if (tmask & fmask)
            return DTERR_BAD_FORMAT;
        fmask |= tmask;
    }

    /* ensure that at least one time field has been found */
    if (fmask == 0)
        return DTERR_BAD_FORMAT;

    /* ensure fractional seconds are fractional */
    if (*fsec != 0)
    {
        int         sec;

#ifdef HAVE_INT64_TIMESTAMP
        sec = *fsec / USECS_PER_SEC;
        *fsec -= sec * USECS_PER_SEC;
#else
        TMODULO(*fsec, sec, 1.0);
#endif
        tm->tm_sec += sec;
    }

    /*----------
     * The SQL standard defines the interval literal
     *   '-1 1:00:00'
     * to mean "negative 1 days and negative 1 hours", while Postgres
     * traditionally treats this as meaning "negative 1 days and positive
     * 1 hours".  In SQL_STANDARD intervalstyle, we apply the leading sign
     * to all fields if there are no other explicit signs.
     *
     * We leave the signs alone if there are additional explicit signs.
     * This protects us against misinterpreting postgres-style dump output,
     * since the postgres-style output code has always put an explicit sign on
     * all fields following a negative field.  But note that SQL-spec output
     * is ambiguous and can be misinterpreted on load!  (So it's best practice
     * to dump in postgres style, not SQL style.)
     *----------
     */
    if (IntervalStyle == INTSTYLE_SQL_STANDARD && *field[0] == '-')
    {
        /* Check for additional explicit signs */
        bool        more_signs = false;

        for (i = 1; i < nf; i++)
        {
            if (*field[i] == '-' || *field[i] == '+')
            {
                more_signs = true;
                break;
            }
        }

        if (!more_signs)
        {
            /*
             * Rather than re-determining which field was field[0], just force
             * 'em all negative.
             */
            if (*fsec > 0)
                *fsec = -(*fsec);
            if (tm->tm_sec > 0)
                tm->tm_sec = -tm->tm_sec;
            if (tm->tm_min > 0)
                tm->tm_min = -tm->tm_min;
            if (tm->tm_hour > 0)
                tm->tm_hour = -tm->tm_hour;
            if (tm->tm_mday > 0)
                tm->tm_mday = -tm->tm_mday;
            if (tm->tm_mon > 0)
                tm->tm_mon = -tm->tm_mon;
            if (tm->tm_year > 0)
                tm->tm_year = -tm->tm_year;
        }
    }

    /* finally, AGO negates everything */
    if (is_before)
    {
        *fsec = -(*fsec);
        tm->tm_sec = -tm->tm_sec;
        tm->tm_min = -tm->tm_min;
        tm->tm_hour = -tm->tm_hour;
        tm->tm_mday = -tm->tm_mday;
        tm->tm_mon = -tm->tm_mon;
        tm->tm_year = -tm->tm_year;
    }

    return 0;
}

int DecodeISO8601Interval ( char *  str,
int *  dtype,
struct pg_tm tm,
fsec_t fsec 
)

Definition at line 3296 of file datetime.c.

References AdjustFractDays(), AdjustFractSeconds(), ClearPgTm(), DAYS_PER_MONTH, ISO8601IntegerWidth(), ParseISO8601Number(), SECS_PER_DAY, SECS_PER_HOUR, SECS_PER_MINUTE, pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, and val.

Referenced by interval_in(), PGTYPESinterval_from_asc(), and reltimein().

{
    bool        datepart = true;
    bool        havefield = false;

    *dtype = DTK_DELTA;
    ClearPgTm(tm, fsec);

    if (strlen(str) < 2 || str[0] != 'P')
        return DTERR_BAD_FORMAT;

    str++;
    while (*str)
    {
        char       *fieldstart;
        int         val;
        double      fval;
        char        unit;
        int         dterr;

        if (*str == 'T')        /* T indicates the beginning of the time part */
        {
            datepart = false;
            havefield = false;
            str++;
            continue;
        }

        fieldstart = str;
        dterr = ParseISO8601Number(str, &str, &val, &fval);
        if (dterr)
            return dterr;

        /*
         * Note: we could step off the end of the string here.  Code below
         * *must* exit the loop if unit == '\0'.
         */
        unit = *str++;

        if (datepart)
        {
            switch (unit)       /* before T: Y M W D */
            {
                case 'Y':
                    tm->tm_year += val;
                    tm->tm_mon += (fval * MONTHS_PER_YEAR);
                    break;
                case 'M':
                    tm->tm_mon += val;
                    AdjustFractDays(fval, tm, fsec, DAYS_PER_MONTH);
                    break;
                case 'W':
                    tm->tm_mday += val * 7;
                    AdjustFractDays(fval, tm, fsec, 7);
                    break;
                case 'D':
                    tm->tm_mday += val;
                    AdjustFractSeconds(fval, tm, fsec, SECS_PER_DAY);
                    break;
                case 'T':       /* ISO 8601 4.4.3.3 Alternative Format / Basic */
                case '\0':
                    if (ISO8601IntegerWidth(fieldstart) == 8 && !havefield)
                    {
                        tm->tm_year += val / 10000;
                        tm->tm_mon += (val / 100) % 100;
                        tm->tm_mday += val % 100;
                        AdjustFractSeconds(fval, tm, fsec, SECS_PER_DAY);
                        if (unit == '\0')
                            return 0;
                        datepart = false;
                        havefield = false;
                        continue;
                    }
                    /* Else fall through to extended alternative format */
                case '-':       /* ISO 8601 4.4.3.3 Alternative Format,
                                 * Extended */
                    if (havefield)
                        return DTERR_BAD_FORMAT;

                    tm->tm_year += val;
                    tm->tm_mon += (fval * MONTHS_PER_YEAR);
                    if (unit == '\0')
                        return 0;
                    if (unit == 'T')
                    {
                        datepart = false;
                        havefield = false;
                        continue;
                    }

                    dterr = ParseISO8601Number(str, &str, &val, &fval);
                    if (dterr)
                        return dterr;
                    tm->tm_mon += val;
                    AdjustFractDays(fval, tm, fsec, DAYS_PER_MONTH);
                    if (*str == '\0')
                        return 0;
                    if (*str == 'T')
                    {
                        datepart = false;
                        havefield = false;
                        continue;
                    }
                    if (*str != '-')
                        return DTERR_BAD_FORMAT;
                    str++;

                    dterr = ParseISO8601Number(str, &str, &val, &fval);
                    if (dterr)
                        return dterr;
                    tm->tm_mday += val;
                    AdjustFractSeconds(fval, tm, fsec, SECS_PER_DAY);
                    if (*str == '\0')
                        return 0;
                    if (*str == 'T')
                    {
                        datepart = false;
                        havefield = false;
                        continue;
                    }
                    return DTERR_BAD_FORMAT;
                default:
                    /* not a valid date unit suffix */
                    return DTERR_BAD_FORMAT;
            }
        }
        else
        {
            switch (unit)       /* after T: H M S */
            {
                case 'H':
                    tm->tm_hour += val;
                    AdjustFractSeconds(fval, tm, fsec, SECS_PER_HOUR);
                    break;
                case 'M':
                    tm->tm_min += val;
                    AdjustFractSeconds(fval, tm, fsec, SECS_PER_MINUTE);
                    break;
                case 'S':
                    tm->tm_sec += val;
                    AdjustFractSeconds(fval, tm, fsec, 1);
                    break;
                case '\0':      /* ISO 8601 4.4.3.3 Alternative Format */
                    if (ISO8601IntegerWidth(fieldstart) == 6 && !havefield)
                    {
                        tm->tm_hour += val / 10000;
                        tm->tm_min += (val / 100) % 100;
                        tm->tm_sec += val % 100;
                        AdjustFractSeconds(fval, tm, fsec, 1);
                        return 0;
                    }
                    /* Else fall through to extended alternative format */
                case ':':       /* ISO 8601 4.4.3.3 Alternative Format,
                                 * Extended */
                    if (havefield)
                        return DTERR_BAD_FORMAT;

                    tm->tm_hour += val;
                    AdjustFractSeconds(fval, tm, fsec, SECS_PER_HOUR);
                    if (unit == '\0')
                        return 0;

                    dterr = ParseISO8601Number(str, &str, &val, &fval);
                    if (dterr)
                        return dterr;
                    tm->tm_min += val;
                    AdjustFractSeconds(fval, tm, fsec, SECS_PER_MINUTE);
                    if (*str == '\0')
                        return 0;
                    if (*str != ':')
                        return DTERR_BAD_FORMAT;
                    str++;

                    dterr = ParseISO8601Number(str, &str, &val, &fval);
                    if (dterr)
                        return dterr;
                    tm->tm_sec += val;
                    AdjustFractSeconds(fval, tm, fsec, 1);
                    if (*str == '\0')
                        return 0;
                    return DTERR_BAD_FORMAT;

                default:
                    /* not a valid time unit suffix */
                    return DTERR_BAD_FORMAT;
            }
        }

        havefield = true;
    }

    return 0;
}

int DecodeSpecial ( int  field,
char *  lowtoken,
int *  val 
)

Definition at line 2789 of file datetime.c.

References datebsearch(), DTZ, DTZMOD, FROMVAL, NULL, szdatetktbl, sztimezonetktbl, datetkn::token, TOKMAXLEN, datetkn::type, TZ, and datetkn::value.

Referenced by DecodeDate(), DecodeDateTime(), DecodePosixTimezone(), DecodeTimeOnly(), interval_part(), time_part(), timestamp_part(), timestamp_zone(), timestamptz_part(), timestamptz_zone(), timetz_part(), timetz_zone(), and tstz_to_ts_gmt().

{
    int         type;
    const datetkn *tp;

    tp = datecache[field];
    if (tp == NULL || strncmp(lowtoken, tp->token, TOKMAXLEN) != 0)
    {
        tp = datebsearch(lowtoken, timezonetktbl, sztimezonetktbl);
        if (tp == NULL)
            tp = datebsearch(lowtoken, datetktbl, szdatetktbl);
    }
    if (tp == NULL)
    {
        type = UNKNOWN_FIELD;
        *val = 0;
    }
    else
    {
        datecache[field] = tp;
        type = tp->type;
        switch (type)
        {
            case TZ:
            case DTZ:
            case DTZMOD:
                *val = FROMVAL(tp);
                break;

            default:
                *val = tp->value;
                break;
        }
    }

    return type;
}

int DecodeTimeOnly ( char **  field,
int *  ftype,
int  nf,
int *  dtype,
struct pg_tm tm,
fsec_t fsec,
int *  tzp 
)

Definition at line 1569 of file datetime.c.

References ADBC, AM, AMPM, DAY, DecodeDate(), DecodeNumber(), DecodeNumberField(), DecodeSpecial(), DecodeTime(), DecodeTimezone(), DetermineTimeZoneOffset(), dt2time(), DTERR_BAD_FORMAT, DTK_CURRENT, DTK_DATE, DTK_DATE_M, DTK_DAY, DTK_HOUR, DTK_JULIAN, DTK_M, DTK_MINUTE, DTK_MONTH, DTK_NOW, DTK_NUMBER, DTK_SECOND, DTK_SPECIAL, DTK_STRING, DTK_TIME, DTK_TIME_M, DTK_TZ, DTK_YEAR, DTK_ZULU, DTZ, DTZMOD, ereport, errcode(), errmsg(), ERROR, FALSE, GetCurrentDateTime(), GetCurrentTimeUsec(), HOUR, HOURS_PER_DAY, HR24, i, IGNORE_DTF, INT64CONST, INTERVAL_FULL_RANGE, ISOTIME, j2date(), MINS_PER_HOUR, MINUTE, MONTH, NULL, ParseFractionalSecond(), pg_get_timezone_offset(), pg_tzset(), PM, RESERV, SECOND, SECS_PER_MINUTE, session_timezone, strtoi(), pg_tm::tm_hour, pg_tm::tm_isdst, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, pg_tm::tm_year, TZ, UNITS, UNKNOWN_FIELD, USECS_PER_SEC, val, ValidateDate(), and YEAR.

Referenced by time_in(), and timetz_in().

{
    int         fmask = 0,
                tmask,
                type;
    int         ptype = 0;      /* "prefix type" for ISO h04mm05s06 format */
    int         i;
    int         val;
    int         dterr;
    bool        isjulian = FALSE;
    bool        is2digits = FALSE;
    bool        bc = FALSE;
    int         mer = HR24;
    pg_tz      *namedTz = NULL;

    *dtype = DTK_TIME;
    tm->tm_hour = 0;
    tm->tm_min = 0;
    tm->tm_sec = 0;
    *fsec = 0;
    /* don't know daylight savings time status apriori */
    tm->tm_isdst = -1;

    if (tzp != NULL)
        *tzp = 0;

    for (i = 0; i < nf; i++)
    {
        switch (ftype[i])
        {
            case DTK_DATE:

                /*
                 * Time zone not allowed? Then should not accept dates or time
                 * zones no matter what else!
                 */
                if (tzp == NULL)
                    return DTERR_BAD_FORMAT;

                /* Under limited circumstances, we will accept a date... */
                if (i == 0 && nf >= 2 &&
                    (ftype[nf - 1] == DTK_DATE || ftype[1] == DTK_TIME))
                {
                    dterr = DecodeDate(field[i], fmask,
                                       &tmask, &is2digits, tm);
                    if (dterr)
                        return dterr;
                }
                /* otherwise, this is a time and/or time zone */
                else
                {
                    if (isdigit((unsigned char) *field[i]))
                    {
                        char       *cp;

                        /*
                         * Starts with a digit but we already have a time
                         * field? Then we are in trouble with time already...
                         */
                        if ((fmask & DTK_TIME_M) == DTK_TIME_M)
                            return DTERR_BAD_FORMAT;

                        /*
                         * Should not get here and fail. Sanity check only...
                         */
                        if ((cp = strchr(field[i], '-')) == NULL)
                            return DTERR_BAD_FORMAT;

                        /* Get the time zone from the end of the string */
                        dterr = DecodeTimezone(cp, tzp);
                        if (dterr)
                            return dterr;
                        *cp = '\0';

                        /*
                         * Then read the rest of the field as a concatenated
                         * time
                         */
                        dterr = DecodeNumberField(strlen(field[i]), field[i],
                                                  (fmask | DTK_DATE_M),
                                                  &tmask, tm,
                                                  fsec, &is2digits);
                        if (dterr < 0)
                            return dterr;
                        ftype[i] = dterr;

                        tmask |= DTK_M(TZ);
                    }
                    else
                    {
                        namedTz = pg_tzset(field[i]);
                        if (!namedTz)
                        {
                            /*
                             * We should return an error code instead of
                             * ereport'ing directly, but then there is no way
                             * to report the bad time zone name.
                             */
                            ereport(ERROR,
                                    (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
                                     errmsg("time zone \"%s\" not recognized",
                                            field[i])));
                        }
                        /* we'll apply the zone setting below */
                        ftype[i] = DTK_TZ;
                        tmask = DTK_M(TZ);
                    }
                }
                break;

            case DTK_TIME:
                dterr = DecodeTime(field[i], (fmask | DTK_DATE_M),
                                   INTERVAL_FULL_RANGE,
                                   &tmask, tm, fsec);
                if (dterr)
                    return dterr;
                break;

            case DTK_TZ:
                {
                    int         tz;

                    if (tzp == NULL)
                        return DTERR_BAD_FORMAT;

                    dterr = DecodeTimezone(field[i], &tz);
                    if (dterr)
                        return dterr;
                    *tzp = tz;
                    tmask = DTK_M(TZ);
                }
                break;

            case DTK_NUMBER:

                /*
                 * Was this an "ISO time" with embedded field labels? An
                 * example is "h04m05s06" - thomas 2001-02-04
                 */
                if (ptype != 0)
                {
                    char       *cp;
                    int         val;

                    /* Only accept a date under limited circumstances */
                    switch (ptype)
                    {
                        case DTK_JULIAN:
                        case DTK_YEAR:
                        case DTK_MONTH:
                        case DTK_DAY:
                            if (tzp == NULL)
                                return DTERR_BAD_FORMAT;
                        default:
                            break;
                    }

                    errno = 0;
                    val = strtoi(field[i], &cp, 10);
                    if (errno == ERANGE)
                        return DTERR_FIELD_OVERFLOW;

                    /*
                     * only a few kinds are allowed to have an embedded
                     * decimal
                     */
                    if (*cp == '.')
                        switch (ptype)
                        {
                            case DTK_JULIAN:
                            case DTK_TIME:
                            case DTK_SECOND:
                                break;
                            default:
                                return DTERR_BAD_FORMAT;
                                break;
                        }
                    else if (*cp != '\0')
                        return DTERR_BAD_FORMAT;

                    switch (ptype)
                    {
                        case DTK_YEAR:
                            tm->tm_year = val;
                            tmask = DTK_M(YEAR);
                            break;

                        case DTK_MONTH:

                            /*
                             * already have a month and hour? then assume
                             * minutes
                             */
                            if ((fmask & DTK_M(MONTH)) != 0 &&
                                (fmask & DTK_M(HOUR)) != 0)
                            {
                                tm->tm_min = val;
                                tmask = DTK_M(MINUTE);
                            }
                            else
                            {
                                tm->tm_mon = val;
                                tmask = DTK_M(MONTH);
                            }
                            break;

                        case DTK_DAY:
                            tm->tm_mday = val;
                            tmask = DTK_M(DAY);
                            break;

                        case DTK_HOUR:
                            tm->tm_hour = val;
                            tmask = DTK_M(HOUR);
                            break;

                        case DTK_MINUTE:
                            tm->tm_min = val;
                            tmask = DTK_M(MINUTE);
                            break;

                        case DTK_SECOND:
                            tm->tm_sec = val;
                            tmask = DTK_M(SECOND);
                            if (*cp == '.')
                            {
                                dterr = ParseFractionalSecond(cp, fsec);
                                if (dterr)
                                    return dterr;
                                tmask = DTK_ALL_SECS_M;
                            }
                            break;

                        case DTK_TZ:
                            tmask = DTK_M(TZ);
                            dterr = DecodeTimezone(field[i], tzp);
                            if (dterr)
                                return dterr;
                            break;

                        case DTK_JULIAN:
                            /* previous field was a label for "julian date" */
                            if (val < 0)
                                return DTERR_FIELD_OVERFLOW;
                            tmask = DTK_DATE_M;
                            j2date(val, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
                            isjulian = TRUE;

                            if (*cp == '.')
                            {
                                double      time;

                                errno = 0;
                                time = strtod(cp, &cp);
                                if (*cp != '\0' || errno != 0)
                                    return DTERR_BAD_FORMAT;

#ifdef HAVE_INT64_TIMESTAMP
                                time *= USECS_PER_DAY;
#else
                                time *= SECS_PER_DAY;
#endif
                                dt2time(time,
                                        &tm->tm_hour, &tm->tm_min,
                                        &tm->tm_sec, fsec);
                                tmask |= DTK_TIME_M;
                            }
                            break;

                        case DTK_TIME:
                            /* previous field was "t" for ISO time */
                            dterr = DecodeNumberField(strlen(field[i]), field[i],
                                                      (fmask | DTK_DATE_M),
                                                      &tmask, tm,
                                                      fsec, &is2digits);
                            if (dterr < 0)
                                return dterr;
                            ftype[i] = dterr;

                            if (tmask != DTK_TIME_M)
                                return DTERR_BAD_FORMAT;
                            break;

                        default:
                            return DTERR_BAD_FORMAT;
                            break;
                    }

                    ptype = 0;
                    *dtype = DTK_DATE;
                }
                else
                {
                    char       *cp;
                    int         flen;

                    flen = strlen(field[i]);
                    cp = strchr(field[i], '.');

                    /* Embedded decimal? */
                    if (cp != NULL)
                    {
                        /*
                         * Under limited circumstances, we will accept a
                         * date...
                         */
                        if (i == 0 && nf >= 2 && ftype[nf - 1] == DTK_DATE)
                        {
                            dterr = DecodeDate(field[i], fmask,
                                               &tmask, &is2digits, tm);
                            if (dterr)
                                return dterr;
                        }
                        /* embedded decimal and several digits before? */
                        else if (flen - strlen(cp) > 2)
                        {
                            /*
                             * Interpret as a concatenated date or time Set
                             * the type field to allow decoding other fields
                             * later. Example: 20011223 or 040506
                             */
                            dterr = DecodeNumberField(flen, field[i],
                                                      (fmask | DTK_DATE_M),
                                                      &tmask, tm,
                                                      fsec, &is2digits);
                            if (dterr < 0)
                                return dterr;
                            ftype[i] = dterr;
                        }
                        else
                            return DTERR_BAD_FORMAT;
                    }
                    else if (flen > 4)
                    {
                        dterr = DecodeNumberField(flen, field[i],
                                                  (fmask | DTK_DATE_M),
                                                  &tmask, tm,
                                                  fsec, &is2digits);
                        if (dterr < 0)
                            return dterr;
                        ftype[i] = dterr;
                    }
                    /* otherwise it is a single date/time field... */
                    else
                    {
                        dterr = DecodeNumber(flen, field[i],
                                             FALSE,
                                             (fmask | DTK_DATE_M),
                                             &tmask, tm,
                                             fsec, &is2digits);
                        if (dterr)
                            return dterr;
                    }
                }
                break;

            case DTK_STRING:
            case DTK_SPECIAL:
                type = DecodeSpecial(i, field[i], &val);
                if (type == IGNORE_DTF)
                    continue;

                tmask = DTK_M(type);
                switch (type)
                {
                    case RESERV:
                        switch (val)
                        {
                            case DTK_CURRENT:
                                ereport(ERROR,
                                     (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
                                      errmsg("date/time value \"current\" is no longer supported")));
                                return DTERR_BAD_FORMAT;
                                break;

                            case DTK_NOW:
                                tmask = DTK_TIME_M;
                                *dtype = DTK_TIME;
                                GetCurrentTimeUsec(tm, fsec, NULL);
                                break;

                            case DTK_ZULU:
                                tmask = (DTK_TIME_M | DTK_M(TZ));
                                *dtype = DTK_TIME;
                                tm->tm_hour = 0;
                                tm->tm_min = 0;
                                tm->tm_sec = 0;
                                tm->tm_isdst = 0;
                                break;

                            default:
                                return DTERR_BAD_FORMAT;
                        }

                        break;

                    case DTZMOD:

                        /*
                         * daylight savings time modifier (solves "MET DST"
                         * syntax)
                         */
                        tmask |= DTK_M(DTZ);
                        tm->tm_isdst = 1;
                        if (tzp == NULL)
                            return DTERR_BAD_FORMAT;
                        *tzp += val * MINS_PER_HOUR;
                        break;

                    case DTZ:

                        /*
                         * set mask for TZ here _or_ check for DTZ later when
                         * getting default timezone
                         */
                        tmask |= DTK_M(TZ);
                        tm->tm_isdst = 1;
                        if (tzp == NULL)
                            return DTERR_BAD_FORMAT;
                        *tzp = val * MINS_PER_HOUR;
                        ftype[i] = DTK_TZ;
                        break;

                    case TZ:
                        tm->tm_isdst = 0;
                        if (tzp == NULL)
                            return DTERR_BAD_FORMAT;
                        *tzp = val * MINS_PER_HOUR;
                        ftype[i] = DTK_TZ;
                        break;

                    case IGNORE_DTF:
                        break;

                    case AMPM:
                        mer = val;
                        break;

                    case ADBC:
                        bc = (val == BC);
                        break;

                    case UNITS:
                        tmask = 0;
                        ptype = val;
                        break;

                    case ISOTIME:
                        tmask = 0;

                        /***
                         * We will need one of the following fields:
                         *  DTK_NUMBER should be hhmmss.fff
                         *  DTK_TIME should be hh:mm:ss.fff
                         *  DTK_DATE should be hhmmss-zz
                         ***/
                        if (i >= nf - 1 ||
                            (ftype[i + 1] != DTK_NUMBER &&
                             ftype[i + 1] != DTK_TIME &&
                             ftype[i + 1] != DTK_DATE))
                            return DTERR_BAD_FORMAT;

                        ptype = val;
                        break;

                    case UNKNOWN_FIELD:

                        /*
                         * Before giving up and declaring error, check to see
                         * if it is an all-alpha timezone name.
                         */
                        namedTz = pg_tzset(field[i]);
                        if (!namedTz)
                            return DTERR_BAD_FORMAT;
                        /* we'll apply the zone setting below */
                        tmask = DTK_M(TZ);
                        break;

                    default:
                        return DTERR_BAD_FORMAT;
                }
                break;

            default:
                return DTERR_BAD_FORMAT;
        }

        if (tmask & fmask)
            return DTERR_BAD_FORMAT;
        fmask |= tmask;
    }                           /* end loop over fields */

    /* do final checking/adjustment of Y/M/D fields */
    dterr = ValidateDate(fmask, isjulian, is2digits, bc, tm);
    if (dterr)
        return dterr;

    /* handle AM/PM */
    if (mer != HR24 && tm->tm_hour > HOURS_PER_DAY / 2)
        return DTERR_FIELD_OVERFLOW;
    if (mer == AM && tm->tm_hour == HOURS_PER_DAY / 2)
        tm->tm_hour = 0;
    else if (mer == PM && tm->tm_hour != HOURS_PER_DAY / 2)
        tm->tm_hour += HOURS_PER_DAY / 2;

    if (tm->tm_hour < 0 || tm->tm_min < 0 || tm->tm_min > MINS_PER_HOUR - 1 ||
        tm->tm_sec < 0 || tm->tm_sec > SECS_PER_MINUTE ||
        tm->tm_hour > HOURS_PER_DAY ||
    /* test for > 24:00:00 */
        (tm->tm_hour == HOURS_PER_DAY &&
         (tm->tm_min > 0 || tm->tm_sec > 0 || *fsec > 0)) ||
#ifdef HAVE_INT64_TIMESTAMP
        *fsec < INT64CONST(0) || *fsec > USECS_PER_SEC
#else
        *fsec < 0 || *fsec > 1
#endif
        )
        return DTERR_FIELD_OVERFLOW;

    if ((fmask & DTK_TIME_M) != DTK_TIME_M)
        return DTERR_BAD_FORMAT;

    /*
     * If we had a full timezone spec, compute the offset (we could not do it
     * before, because we may need the date to resolve DST status).
     */
    if (namedTz != NULL)
    {
        long int    gmtoff;

        /* daylight savings time modifier disallowed with full TZ */
        if (fmask & DTK_M(DTZMOD))
            return DTERR_BAD_FORMAT;

        /* if non-DST zone, we do not need to know the date */
        if (pg_get_timezone_offset(namedTz, &gmtoff))
        {
            *tzp = -(int) gmtoff;
        }
        else
        {
            /* a date has to be specified */
            if ((fmask & DTK_DATE_M) != DTK_DATE_M)
                return DTERR_BAD_FORMAT;
            *tzp = DetermineTimeZoneOffset(tm, namedTz);
        }
    }

    /* timezone not specified? then find local timezone if possible */
    if (tzp != NULL && !(fmask & DTK_M(TZ)))
    {
        struct pg_tm tt,
                   *tmp = &tt;

        /*
         * daylight savings time modifier but no standard timezone? then error
         */
        if (fmask & DTK_M(DTZMOD))
            return DTERR_BAD_FORMAT;

        if ((fmask & DTK_DATE_M) == 0)
            GetCurrentDateTime(tmp);
        else
        {
            tmp->tm_year = tm->tm_year;
            tmp->tm_mon = tm->tm_mon;
            tmp->tm_mday = tm->tm_mday;
        }
        tmp->tm_hour = tm->tm_hour;
        tmp->tm_min = tm->tm_min;
        tmp->tm_sec = tm->tm_sec;
        *tzp = DetermineTimeZoneOffset(tmp, session_timezone);
        tm->tm_isdst = tmp->tm_isdst;
    }

    return 0;
}

int DecodeUnits ( int  field,
char *  lowtoken,
int *  val 
)

Definition at line 3498 of file datetime.c.

{
    int         type;
    const datetkn *tp;

    tp = deltacache[field];
    if (tp == NULL || strncmp(lowtoken, tp->token, TOKMAXLEN) != 0)
    {
        tp = datebsearch(lowtoken, deltatktbl, szdeltatktbl);
    }
    if (tp == NULL)
    {
        type = UNKNOWN_FIELD;
        *val = 0;
    }
    else
    {
        deltacache[field] = tp;
        type = tp->type;
        if (type == TZ || type == DTZ)
            *val = FROMVAL(tp);
        else
            *val = tp->value;
    }

    return type;
}   /* DecodeUnits() */

int DetermineTimeZoneOffset ( struct pg_tm tm,
pg_tz tzp 
)

Definition at line 1441 of file datetime.c.

References CTimeZone, date2j(), HasCTZSet, IS_VALID_JULIAN, pg_next_dst_boundary(), SECS_PER_DAY, SECS_PER_MINUTE, session_timezone, pg_tm::tm_hour, pg_tm::tm_isdst, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, and pg_tm::tm_year.

Referenced by date2timestamptz(), DecodeDateTime(), DecodeTimeOnly(), time_timetz(), timestamp2timestamptz(), timestamp_abstime(), timestamp_zone(), timestamptz_pl_interval(), timestamptz_trunc(), and to_timestamp().

{
    int         date,
                sec;
    pg_time_t   day,
                mytime,
                prevtime,
                boundary,
                beforetime,
                aftertime;
    long int    before_gmtoff,
                after_gmtoff;
    int         before_isdst,
                after_isdst;
    int         res;

    if (tzp == session_timezone && HasCTZSet)
    {
        tm->tm_isdst = 0;       /* for lack of a better idea */
        return CTimeZone;
    }

    /*
     * First, generate the pg_time_t value corresponding to the given
     * y/m/d/h/m/s taken as GMT time.  If this overflows, punt and decide the
     * timezone is GMT.  (We only need to worry about overflow on machines
     * where pg_time_t is 32 bits.)
     */
    if (!IS_VALID_JULIAN(tm->tm_year, tm->tm_mon, tm->tm_mday))
        goto overflow;
    date = date2j(tm->tm_year, tm->tm_mon, tm->tm_mday) - UNIX_EPOCH_JDATE;

    day = ((pg_time_t) date) * SECS_PER_DAY;
    if (day / SECS_PER_DAY != date)
        goto overflow;
    sec = tm->tm_sec + (tm->tm_min + tm->tm_hour * MINS_PER_HOUR) * SECS_PER_MINUTE;
    mytime = day + sec;
    /* since sec >= 0, overflow could only be from +day to -mytime */
    if (mytime < 0 && day > 0)
        goto overflow;

    /*
     * Find the DST time boundary just before or following the target time. We
     * assume that all zones have GMT offsets less than 24 hours, and that DST
     * boundaries can't be closer together than 48 hours, so backing up 24
     * hours and finding the "next" boundary will work.
     */
    prevtime = mytime - SECS_PER_DAY;
    if (mytime < 0 && prevtime > 0)
        goto overflow;

    res = pg_next_dst_boundary(&prevtime,
                               &before_gmtoff, &before_isdst,
                               &boundary,
                               &after_gmtoff, &after_isdst,
                               tzp);
    if (res < 0)
        goto overflow;          /* failure? */

    if (res == 0)
    {
        /* Non-DST zone, life is simple */
        tm->tm_isdst = before_isdst;
        return -(int) before_gmtoff;
    }

    /*
     * Form the candidate pg_time_t values with local-time adjustment
     */
    beforetime = mytime - before_gmtoff;
    if ((before_gmtoff > 0 &&
         mytime < 0 && beforetime > 0) ||
        (before_gmtoff <= 0 &&
         mytime > 0 && beforetime < 0))
        goto overflow;
    aftertime = mytime - after_gmtoff;
    if ((after_gmtoff > 0 &&
         mytime < 0 && aftertime > 0) ||
        (after_gmtoff <= 0 &&
         mytime > 0 && aftertime < 0))
        goto overflow;

    /*
     * If both before or both after the boundary time, we know what to do
     */
    if (beforetime <= boundary && aftertime < boundary)
    {
        tm->tm_isdst = before_isdst;
        return -(int) before_gmtoff;
    }
    if (beforetime > boundary && aftertime >= boundary)
    {
        tm->tm_isdst = after_isdst;
        return -(int) after_gmtoff;
    }

    /*
     * It's an invalid or ambiguous time due to timezone transition. Prefer
     * the standard-time interpretation.
     */
    if (after_isdst == 0)
    {
        tm->tm_isdst = after_isdst;
        return -(int) after_gmtoff;
    }
    tm->tm_isdst = before_isdst;
    return -(int) before_gmtoff;

overflow:
    /* Given date is out of range, so assume UTC */
    tm->tm_isdst = 0;
    return 0;
}

void EncodeDateOnly ( struct pg_tm tm,
int  style,
char *  str 
)

Definition at line 3641 of file datetime.c.

References Assert, DateOrder, DATEORDER_DMY, MONTHS_PER_YEAR, pg_tm::tm_mday, pg_tm::tm_mon, pg_tm::tm_year, USE_GERMAN_DATES, USE_ISO_DATES, USE_POSTGRES_DATES, USE_SQL_DATES, and USE_XSD_DATES.

Referenced by date_out(), map_sql_value_to_xml_value(), and PGTYPESdate_to_asc().

{
    Assert(tm->tm_mon >= 1 && tm->tm_mon <= MONTHS_PER_YEAR);

    switch (style)
    {
        case USE_ISO_DATES:
        case USE_XSD_DATES:
            /* compatible with ISO date formats */
            if (tm->tm_year > 0)
                sprintf(str, "%04d-%02d-%02d",
                        tm->tm_year, tm->tm_mon, tm->tm_mday);
            else
                sprintf(str, "%04d-%02d-%02d %s",
                        -(tm->tm_year - 1), tm->tm_mon, tm->tm_mday, "BC");
            break;

        case USE_SQL_DATES:
            /* compatible with Oracle/Ingres date formats */
            if (DateOrder == DATEORDER_DMY)
                sprintf(str, "%02d/%02d", tm->tm_mday, tm->tm_mon);
            else
                sprintf(str, "%02d/%02d", tm->tm_mon, tm->tm_mday);
            if (tm->tm_year > 0)
                sprintf(str + 5, "/%04d", tm->tm_year);
            else
                sprintf(str + 5, "/%04d %s", -(tm->tm_year - 1), "BC");
            break;

        case USE_GERMAN_DATES:
            /* German-style date format */
            sprintf(str, "%02d.%02d", tm->tm_mday, tm->tm_mon);
            if (tm->tm_year > 0)
                sprintf(str + 5, ".%04d", tm->tm_year);
            else
                sprintf(str + 5, ".%04d %s", -(tm->tm_year - 1), "BC");
            break;

        case USE_POSTGRES_DATES:
        default:
            /* traditional date-only style for Postgres */
            if (DateOrder == DATEORDER_DMY)
                sprintf(str, "%02d-%02d", tm->tm_mday, tm->tm_mon);
            else
                sprintf(str, "%02d-%02d", tm->tm_mon, tm->tm_mday);
            if (tm->tm_year > 0)
                sprintf(str + 5, "-%04d", tm->tm_year);
            else
                sprintf(str + 5, "-%04d %s", -(tm->tm_year - 1), "BC");
            break;
    }
}

void EncodeDateTime ( struct pg_tm tm,
fsec_t  fsec,
bool  print_tz,
int  tz,
const char *  tzn,
int  style,
char *  str 
)

Definition at line 3733 of file datetime.c.

References AppendTimestampSeconds(), Assert, date2j(), DateOrder, DATEORDER_DMY, days, EncodeTimezone(), j2day(), MAXTZLEN, months, MONTHS_PER_YEAR, pg_tm::tm_hour, pg_tm::tm_isdst, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_wday, pg_tm::tm_year, USE_GERMAN_DATES, USE_ISO_DATES, USE_POSTGRES_DATES, USE_SQL_DATES, and USE_XSD_DATES.

Referenced by abstimeout(), map_sql_value_to_xml_value(), PGTYPEStimestamp_to_asc(), timestamp_out(), timestamptz_out(), and timestamptz_to_str().

{
    int         day;

    Assert(tm->tm_mon >= 1 && tm->tm_mon <= MONTHS_PER_YEAR);

    /*
     * Negative tm_isdst means we have no valid time zone translation.
     */
    if (tm->tm_isdst < 0)
        print_tz = false;

    switch (style)
    {
        case USE_ISO_DATES:
        case USE_XSD_DATES:
            /* Compatible with ISO-8601 date formats */

            if (style == USE_ISO_DATES)
                sprintf(str, "%04d-%02d-%02d %02d:%02d:",
                        (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1),
                        tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min);
            else
                sprintf(str, "%04d-%02d-%02dT%02d:%02d:",
                        (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1),
                        tm->tm_mon, tm->tm_mday, tm->tm_hour, tm->tm_min);

            AppendTimestampSeconds(str + strlen(str), tm, fsec);

            if (print_tz)
                EncodeTimezone(str, tz, style);

            if (tm->tm_year <= 0)
                sprintf(str + strlen(str), " BC");
            break;

        case USE_SQL_DATES:
            /* Compatible with Oracle/Ingres date formats */

            if (DateOrder == DATEORDER_DMY)
                sprintf(str, "%02d/%02d", tm->tm_mday, tm->tm_mon);
            else
                sprintf(str, "%02d/%02d", tm->tm_mon, tm->tm_mday);

            sprintf(str + 5, "/%04d %02d:%02d:",
                    (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1),
                    tm->tm_hour, tm->tm_min);

            AppendTimestampSeconds(str + strlen(str), tm, fsec);

            /*
             * Note: the uses of %.*s in this function would be risky if the
             * timezone names ever contain non-ASCII characters.  However, all
             * TZ abbreviations in the Olson database are plain ASCII.
             */

            if (print_tz)
            {
                if (tzn)
                    sprintf(str + strlen(str), " %.*s", MAXTZLEN, tzn);
                else
                    EncodeTimezone(str, tz, style);
            }

            if (tm->tm_year <= 0)
                sprintf(str + strlen(str), " BC");
            break;

        case USE_GERMAN_DATES:
            /* German variant on European style */

            sprintf(str, "%02d.%02d", tm->tm_mday, tm->tm_mon);

            sprintf(str + 5, ".%04d %02d:%02d:",
                    (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1),
                    tm->tm_hour, tm->tm_min);

            AppendTimestampSeconds(str + strlen(str), tm, fsec);

            if (print_tz)
            {
                if (tzn)
                    sprintf(str + strlen(str), " %.*s", MAXTZLEN, tzn);
                else
                    EncodeTimezone(str, tz, style);
            }

            if (tm->tm_year <= 0)
                sprintf(str + strlen(str), " BC");
            break;

        case USE_POSTGRES_DATES:
        default:
            /* Backward-compatible with traditional Postgres abstime dates */

            day = date2j(tm->tm_year, tm->tm_mon, tm->tm_mday);
            tm->tm_wday = j2day(day);

            strncpy(str, days[tm->tm_wday], 3);
            strcpy(str + 3, " ");

            if (DateOrder == DATEORDER_DMY)
                sprintf(str + 4, "%02d %3s", tm->tm_mday, months[tm->tm_mon - 1]);
            else
                sprintf(str + 4, "%3s %02d", months[tm->tm_mon - 1], tm->tm_mday);

            sprintf(str + 10, " %02d:%02d:", tm->tm_hour, tm->tm_min);

            AppendTimestampSeconds(str + strlen(str), tm, fsec);

            sprintf(str + strlen(str), " %04d",
                    (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1));

            if (print_tz)
            {
                if (tzn)
                    sprintf(str + strlen(str), " %.*s", MAXTZLEN, tzn);
                else
                {
                    /*
                     * We have a time zone, but no string version. Use the
                     * numeric form, but be sure to include a leading space to
                     * avoid formatting something which would be rejected by
                     * the date/time parser later. - thomas 2001-10-19
                     */
                    sprintf(str + strlen(str), " ");
                    EncodeTimezone(str, tz, style);
                }
            }

            if (tm->tm_year <= 0)
                sprintf(str + strlen(str), " BC");
            break;
    }
}

void EncodeInterval ( struct pg_tm tm,
fsec_t  fsec,
int  style,
char *  str 
)

Definition at line 3948 of file datetime.c.

References AddISO8601IntPart(), AddPostgresIntPart(), AddVerboseIntPart(), AppendSeconds(), INTSTYLE_ISO_8601, INTSTYLE_POSTGRES, INTSTYLE_POSTGRES_VERBOSE, INTSTYLE_SQL_STANDARD, MAX_INTERVAL_PRECISION, pg_tm::tm_hour, pg_tm::tm_mday, pg_tm::tm_min, pg_tm::tm_mon, pg_tm::tm_sec, and pg_tm::tm_year.

Referenced by interval_out(), PGTYPESinterval_to_asc(), and reltimeout().

{
    char       *cp = str;
    int         year = tm->tm_year;
    int         mon = tm->tm_mon;
    int         mday = tm->tm_mday;
    int         hour = tm->tm_hour;
    int         min = tm->tm_min;
    int         sec = tm->tm_sec;
    bool        is_before = FALSE;
    bool        is_zero = TRUE;

    /*
     * The sign of year and month are guaranteed to match, since they are
     * stored internally as "month". But we'll need to check for is_before and
     * is_zero when determining the signs of day and hour/minute/seconds
     * fields.
     */
    switch (style)
    {
            /* SQL Standard interval format */
        case INTSTYLE_SQL_STANDARD:
            {
                bool        has_negative = year < 0 || mon < 0 ||
                mday < 0 || hour < 0 ||
                min < 0 || sec < 0 || fsec < 0;
                bool        has_positive = year > 0 || mon > 0 ||
                mday > 0 || hour > 0 ||
                min > 0 || sec > 0 || fsec > 0;
                bool        has_year_month = year != 0 || mon != 0;
                bool        has_day_time = mday != 0 || hour != 0 ||
                min != 0 || sec != 0 || fsec != 0;
                bool        has_day = mday != 0;
                bool        sql_standard_value = !(has_negative && has_positive) &&
                !(has_year_month && has_day_time);

                /*
                 * SQL Standard wants only 1 "<sign>" preceding the whole
                 * interval ... but can't do that if mixed signs.
                 */
                if (has_negative && sql_standard_value)
                {
                    *cp++ = '-';
                    year = -year;
                    mon = -mon;
                    mday = -mday;
                    hour = -hour;
                    min = -min;
                    sec = -sec;
                    fsec = -fsec;
                }

                if (!has_negative && !has_positive)
                {
                    sprintf(cp, "0");
                }
                else if (!sql_standard_value)
                {
                    /*
                     * For non sql-standard interval values, force outputting
                     * the signs to avoid ambiguities with intervals with
                     * mixed sign components.
                     */
                    char        year_sign = (year < 0 || mon < 0) ? '-' : '+';
                    char        day_sign = (mday < 0) ? '-' : '+';
                    char        sec_sign = (hour < 0 || min < 0 ||
                                            sec < 0 || fsec < 0) ? '-' : '+';

                    sprintf(cp, "%c%d-%d %c%d %c%d:%02d:",
                            year_sign, abs(year), abs(mon),
                            day_sign, abs(mday),
                            sec_sign, abs(hour), abs(min));
                    cp += strlen(cp);
                    AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
                }
                else if (has_year_month)
                {
                    sprintf(cp, "%d-%d", year, mon);
                }
                else if (has_day)
                {
                    sprintf(cp, "%d %d:%02d:", mday, hour, min);
                    cp += strlen(cp);
                    AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
                }
                else
                {
                    sprintf(cp, "%d:%02d:", hour, min);
                    cp += strlen(cp);
                    AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
                }
            }
            break;

            /* ISO 8601 "time-intervals by duration only" */
        case INTSTYLE_ISO_8601:
            /* special-case zero to avoid printing nothing */
            if (year == 0 && mon == 0 && mday == 0 &&
                hour == 0 && min == 0 && sec == 0 && fsec == 0)
            {
                sprintf(cp, "PT0S");
                break;
            }
            *cp++ = 'P';
            cp = AddISO8601IntPart(cp, year, 'Y');
            cp = AddISO8601IntPart(cp, mon, 'M');
            cp = AddISO8601IntPart(cp, mday, 'D');
            if (hour != 0 || min != 0 || sec != 0 || fsec != 0)
                *cp++ = 'T';
            cp = AddISO8601IntPart(cp, hour, 'H');
            cp = AddISO8601IntPart(cp, min, 'M');
            if (sec != 0 || fsec != 0)
            {
                if (sec < 0 || fsec < 0)
                    *cp++ = '-';
                AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, false);
                cp += strlen(cp);
                *cp++ = 'S';
                *cp++ = '\0';
            }
            break;

            /* Compatible with postgresql < 8.4 when DateStyle = 'iso' */
        case INTSTYLE_POSTGRES:
            cp = AddPostgresIntPart(cp, year, "year", &is_zero, &is_before);

            /*
             * Ideally we should spell out "month" like we do for "year" and
             * "day".  However, for backward compatibility, we can't easily
             * fix this.  bjm 2011-05-24
             */
            cp = AddPostgresIntPart(cp, mon, "mon", &is_zero, &is_before);
            cp = AddPostgresIntPart(cp, mday, "day", &is_zero, &is_before);
            if (is_zero || hour != 0 || min != 0 || sec != 0 || fsec != 0)
            {
                bool        minus = (hour < 0 || min < 0 || sec < 0 || fsec < 0);

                sprintf(cp, "%s%s%02d:%02d:",
                        is_zero ? "" : " ",
                        (minus ? "-" : (is_before ? "+" : "")),
                        abs(hour), abs(min));
                cp += strlen(cp);
                AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
            }
            break;

            /* Compatible with postgresql < 8.4 when DateStyle != 'iso' */
        case INTSTYLE_POSTGRES_VERBOSE:
        default:
            strcpy(cp, "@");
            cp++;
            cp = AddVerboseIntPart(cp, year, "year", &is_zero, &is_before);
            cp = AddVerboseIntPart(cp, mon, "mon", &is_zero, &is_before);
            cp = AddVerboseIntPart(cp, mday, "day", &is_zero, &is_before);
            cp = AddVerboseIntPart(cp, hour, "hour", &is_zero, &is_before);
            cp = AddVerboseIntPart(cp, min, "min", &is_zero, &is_before);
            if (sec != 0 || fsec != 0)
            {
                *cp++ = ' ';
                if (sec < 0 || (sec == 0 && fsec < 0))
                {
                    if (is_zero)
                        is_before = TRUE;
                    else if (!is_before)
                        *cp++ = '-';
                }
                else if (is_before)
                    *cp++ = '-';
                AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, false);
                cp += strlen(cp);
                sprintf(cp, " sec%s",
                        (abs(sec) != 1 || fsec != 0) ? "s" : "");
                is_zero = FALSE;
            }
            /* identically zero? then put in a unitless zero... */
            if (is_zero)
                strcat(cp, " 0");
            if (is_before)
                strcat(cp, " ago");
            break;
    }
}

void EncodeTimeOnly ( struct pg_tm tm,
fsec_t  fsec,
bool  print_tz,
int  tz,
int  style,
char *  str 
)

Definition at line 3704 of file datetime.c.

References AppendSeconds(), EncodeTimezone(), MAX_TIME_PRECISION, pg_tm::tm_hour, pg_tm::tm_min, and pg_tm::tm_sec.

Referenced by time_out(), and timetz_out().

{
    sprintf(str, "%02d:%02d:", tm->tm_hour, tm->tm_min);
    str += strlen(str);

    AppendSeconds(str, tm->tm_sec, fsec, MAX_TIME_PRECISION, true);

    if (print_tz)
        EncodeTimezone(str, tz, style);
}

void GetCurrentDateTime ( struct pg_tm tm  ) 

Definition at line 380 of file datetime.c.

References GetCurrentTransactionStartTimestamp(), NULL, and timestamp2tm().

Referenced by date_in(), DecodeDateTime(), DecodeTimeOnly(), PGTYPESdate_today(), PGTYPEStimestamp_current(), and time_timetz().

{
    int         tz;
    fsec_t      fsec;

    timestamp2tm(GetCurrentTransactionStartTimestamp(), &tz, tm, &fsec,
                 NULL, NULL);
    /* Note: don't pass NULL tzp to timestamp2tm; affects behavior */
}

void GetCurrentTimeUsec ( struct pg_tm tm,
fsec_t fsec,
int *  tzp 
)

Definition at line 397 of file datetime.c.

References GetCurrentTransactionStartTimestamp(), NULL, and timestamp2tm().

Referenced by DecodeDateTime(), and DecodeTimeOnly().

{
    int         tz;

    timestamp2tm(GetCurrentTransactionStartTimestamp(), &tz, tm, fsec,
                 NULL, NULL);
    /* Note: don't pass NULL tzp to timestamp2tm; affects behavior */
    if (tzp != NULL)
        *tzp = tz;
}

void InstallTimeZoneAbbrevs ( TimeZoneAbbrevTable tbl  ) 

Definition at line 4236 of file datetime.c.

References TimeZoneAbbrevTable::abbrevs, i, NULL, TimeZoneAbbrevTable::numabbrevs, and sztimezonetktbl.

Referenced by assign_timezone_abbreviations().

{
    int         i;

    timezonetktbl = tbl->abbrevs;
    sztimezonetktbl = tbl->numabbrevs;

    /* clear date cache in case it contains any stale timezone names */
    for (i = 0; i < MAXDATEFIELDS; i++)
        datecache[i] = NULL;
}

void j2date ( int  jd,
int *  year,
int *  month,
int *  day 
)

Definition at line 326 of file datetime.c.

{
    unsigned int julian;
    unsigned int quad;
    unsigned int extra;
    int         y;

    julian = jd;
    julian += 32044;
    quad = julian / 146097;
    extra = (julian - quad * 146097) * 4 + 3;
    julian += 60 + quad * 3 + extra / 146097;
    quad = julian / 1461;
    julian -= quad * 1461;
    y = julian * 4 / 1461;
    julian = ((y != 0) ? ((julian + 305) % 365) : ((julian + 306) % 366))
        + 123;
    y += quad * 4;
    *year = y - 4800;
    quad = julian * 2141 / 65536;
    *day = julian - 7834 * quad / 256;
    *month = (quad + 10) % MONTHS_PER_YEAR + 1;

    return;
}   /* j2date() */

int j2day ( int  jd  ) 

Definition at line 361 of file datetime.c.

Referenced by date2isoweek(), date2isoyear(), EncodeDateTime(), isoweek2j(), timestamp_part(), and timestamptz_part().

{
    unsigned int day;

    day = date;

    day += 1;
    day %= 7;

    return (int) day;
}   /* j2day() */

int ParseDateTime ( const char *  timestr,
char *  workbuf,
size_t  buflen,
char **  field,
int *  ftype,
int  maxfields,
int *  numfields 
)

Definition at line 567 of file datetime.c.

References APPEND_CHAR, datebsearch(), DTK_DATE, DTK_NUMBER, NULL, pg_tolower(), and szdatetktbl.

Referenced by abstimein(), date_in(), interval_in(), pg_logdir_ls(), PGTYPESdate_from_asc(), PGTYPESinterval_from_asc(), PGTYPEStimestamp_from_asc(), reltimein(), time_in(), timestamp_in(), timestamptz_in(), and timetz_in().

{
    int         nf = 0;
    const char *cp = timestr;
    char       *bufp = workbuf;
    const char *bufend = workbuf + buflen;

    /*
     * Set the character pointed-to by "bufptr" to "newchar", and increment
     * "bufptr". "end" gives the end of the buffer -- we return an error if
     * there is no space left to append a character to the buffer. Note that
     * "bufptr" is evaluated twice.
     */
#define APPEND_CHAR(bufptr, end, newchar)       \
    do                                          \
    {                                           \
        if (((bufptr) + 1) >= (end))            \
            return DTERR_BAD_FORMAT;            \
        *(bufptr)++ = newchar;                  \
    } while (0)

    /* outer loop through fields */
    while (*cp != '\0')
    {
        /* Ignore spaces between fields */
        if (isspace((unsigned char) *cp))
        {
            cp++;
            continue;
        }

        /* Record start of current field */
        if (nf >= maxfields)
            return DTERR_BAD_FORMAT;
        field[nf] = bufp;

        /* leading digit? then date or time */
        if (isdigit((unsigned char) *cp))
        {
            APPEND_CHAR(bufp, bufend, *cp++);
            while (isdigit((unsigned char) *cp))
                APPEND_CHAR(bufp, bufend, *cp++);

            /* time field? */
            if (*cp == ':')
            {
                ftype[nf] = DTK_TIME;
                APPEND_CHAR(bufp, bufend, *cp++);
                while (isdigit((unsigned char) *cp) ||
                       (*cp == ':') || (*cp == '.'))
                    APPEND_CHAR(bufp, bufend, *cp++);
            }
            /* date field? allow embedded text month */
            else if (*cp == '-' || *cp == '/' || *cp == '.')
            {
                /* save delimiting character to use later */
                char        delim = *cp;

                APPEND_CHAR(bufp, bufend, *cp++);
                /* second field is all digits? then no embedded text month */
                if (isdigit((unsigned char) *cp))
                {
                    ftype[nf] = ((delim == '.') ? DTK_NUMBER : DTK_DATE);
                    while (isdigit((unsigned char) *cp))
                        APPEND_CHAR(bufp, bufend, *cp++);

                    /*
                     * insist that the delimiters match to get a three-field
                     * date.
                     */
                    if (*cp == delim)
                    {
                        ftype[nf] = DTK_DATE;
                        APPEND_CHAR(bufp, bufend, *cp++);
                        while (isdigit((unsigned char) *cp) || *cp == delim)
                            APPEND_CHAR(bufp, bufend, *cp++);
                    }
                }
                else
                {
                    ftype[nf] = DTK_DATE;
                    while (isalnum((unsigned char) *cp) || *cp == delim)
                        APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
                }
            }

            /*
             * otherwise, number only and will determine year, month, day, or
             * concatenated fields later...
             */
            else
                ftype[nf] = DTK_NUMBER;
        }
        /* Leading decimal point? Then fractional seconds... */
        else if (*cp == '.')
        {
            APPEND_CHAR(bufp, bufend, *cp++);
            while (isdigit((unsigned char) *cp))
                APPEND_CHAR(bufp, bufend, *cp++);

            ftype[nf] = DTK_NUMBER;
        }

        /*
         * text? then date string, month, day of week, special, or timezone
         */
        else if (isalpha((unsigned char) *cp))
        {
            bool        is_date;

            ftype[nf] = DTK_STRING;
            APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
            while (isalpha((unsigned char) *cp))
                APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));

            /*
             * Dates can have embedded '-', '/', or '.' separators.  It could
             * also be a timezone name containing embedded '/', '+', '-', '_',
             * or ':' (but '_' or ':' can't be the first punctuation). If the
             * next character is a digit or '+', we need to check whether what
             * we have so far is a recognized non-timezone keyword --- if so,
             * don't believe that this is the start of a timezone.
             */
            is_date = false;
            if (*cp == '-' || *cp == '/' || *cp == '.')
                is_date = true;
            else if (*cp == '+' || isdigit((unsigned char) *cp))
            {
                *bufp = '\0';   /* null-terminate current field value */
                /* we need search only the core token table, not TZ names */
                if (datebsearch(field[nf], datetktbl, szdatetktbl) == NULL)
                    is_date = true;
            }
            if (is_date)
            {
                ftype[nf] = DTK_DATE;
                do
                {
                    APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
                } while (*cp == '+' || *cp == '-' ||
                         *cp == '/' || *cp == '_' ||
                         *cp == '.' || *cp == ':' ||
                         isalnum((unsigned char) *cp));
            }
        }
        /* sign? then special or numeric timezone */
        else if (*cp == '+' || *cp == '-')
        {
            APPEND_CHAR(bufp, bufend, *cp++);
            /* soak up leading whitespace */
            while (isspace((unsigned char) *cp))
                cp++;
            /* numeric timezone? */
            /* note that "DTK_TZ" could also be a signed float or yyyy-mm */
            if (isdigit((unsigned char) *cp))
            {
                ftype[nf] = DTK_TZ;
                APPEND_CHAR(bufp, bufend, *cp++);
                while (isdigit((unsigned char) *cp) ||
                       *cp == ':' || *cp == '.' || *cp == '-')
                    APPEND_CHAR(bufp, bufend, *cp++);
            }
            /* special? */
            else if (isalpha((unsigned char) *cp))
            {
                ftype[nf] = DTK_SPECIAL;
                APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
                while (isalpha((unsigned char) *cp))
                    APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
            }
            /* otherwise something wrong... */
            else
                return DTERR_BAD_FORMAT;
        }
        /* ignore other punctuation but use as delimiter */
        else if (ispunct((unsigned char) *cp))
        {
            cp++;
            continue;
        }
        /* otherwise, something is not right... */
        else
            return DTERR_BAD_FORMAT;

        /* force in a delimiter after each field */
        *bufp++ = '\0';
        nf++;
    }

    *numfields = nf;

    return 0;
}

Datum pg_timezone_abbrevs ( PG_FUNCTION_ARGS   ) 

Definition at line 4253 of file datetime.c.

References Assert, BlessTupleDesc(), BoolGetDatum, BOOLOID, CreateTemplateTupleDesc(), CStringGetTextDatum, DTZ, FROMVAL, heap_form_tuple(), HeapTupleGetDatum, INTERVALOID, IntervalPGetDatum, MemoryContextSwitchTo(), MemSet, FuncCallContext::multi_call_memory_ctx, palloc(), pg_toupper(), SRF_FIRSTCALL_INIT, SRF_IS_FIRSTCALL, SRF_PERCALL_SETUP, SRF_RETURN_DONE, SRF_RETURN_NEXT, sztimezonetktbl, TEXTOID, tm2interval(), pg_tm::tm_min, TOKMAXLEN, FuncCallContext::tuple_desc, TupleDescInitEntry(), TZ, FuncCallContext::user_fctx, and values.

{
    FuncCallContext *funcctx;
    int        *pindex;
    Datum       result;
    HeapTuple   tuple;
    Datum       values[3];
    bool        nulls[3];
    char        buffer[TOKMAXLEN + 1];
    unsigned char *p;
    struct pg_tm tm;
    Interval   *resInterval;

    /* stuff done only on the first call of the function */
    if (SRF_IS_FIRSTCALL())
    {
        TupleDesc   tupdesc;
        MemoryContext oldcontext;

        /* create a function context for cross-call persistence */
        funcctx = SRF_FIRSTCALL_INIT();

        /*
         * switch to memory context appropriate for multiple function calls
         */
        oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);

        /* allocate memory for user context */
        pindex = (int *) palloc(sizeof(int));
        *pindex = 0;
        funcctx->user_fctx = (void *) pindex;

        /*
         * build tupdesc for result tuples. This must match this function's
         * pg_proc entry!
         */
        tupdesc = CreateTemplateTupleDesc(3, false);
        TupleDescInitEntry(tupdesc, (AttrNumber) 1, "abbrev",
                           TEXTOID, -1, 0);
        TupleDescInitEntry(tupdesc, (AttrNumber) 2, "utc_offset",
                           INTERVALOID, -1, 0);
        TupleDescInitEntry(tupdesc, (AttrNumber) 3, "is_dst",
                           BOOLOID, -1, 0);

        funcctx->tuple_desc = BlessTupleDesc(tupdesc);
        MemoryContextSwitchTo(oldcontext);
    }

    /* stuff done on every call of the function */
    funcctx = SRF_PERCALL_SETUP();
    pindex = (int *) funcctx->user_fctx;

    if (*pindex >= sztimezonetktbl)
        SRF_RETURN_DONE(funcctx);

    MemSet(nulls, 0, sizeof(nulls));

    /*
     * Convert name to text, using upcasing conversion that is the inverse of
     * what ParseDateTime() uses.
     */
    strncpy(buffer, timezonetktbl[*pindex].token, TOKMAXLEN);
    buffer[TOKMAXLEN] = '\0';   /* may not be null-terminated */
    for (p = (unsigned char *) buffer; *p; p++)
        *p = pg_toupper(*p);

    values[0] = CStringGetTextDatum(buffer);

    MemSet(&tm, 0, sizeof(struct pg_tm));
    tm.tm_min = (-1) * FROMVAL(&timezonetktbl[*pindex]);
    resInterval = (Interval *) palloc(sizeof(Interval));
    tm2interval(&tm, 0, resInterval);
    values[1] = IntervalPGetDatum(resInterval);

    Assert(timezonetktbl[*pindex].type == DTZ ||
           timezonetktbl[*pindex].type == TZ);
    values[2] = BoolGetDatum(timezonetktbl[*pindex].type == DTZ);

    (*pindex)++;

    tuple = heap_form_tuple(funcctx->tuple_desc, values, nulls);
    result = HeapTupleGetDatum(tuple);

    SRF_RETURN_NEXT(funcctx, result);
}

Datum pg_timezone_names ( PG_FUNCTION_ARGS   ) 

Definition at line 4344 of file datetime.c.

References BlessTupleDesc(), BoolGetDatum, BOOLOID, CreateTemplateTupleDesc(), CStringGetTextDatum, GetCurrentTransactionStartTimestamp(), heap_form_tuple(), HeapTupleGetDatum, INTERVALOID, IntervalPGetDatum, MemoryContextSwitchTo(), MemSet, FuncCallContext::multi_call_memory_ctx, palloc(), pg_get_timezone_name(), pg_tzenumerate_end(), pg_tzenumerate_next(), pg_tzenumerate_start(), SRF_FIRSTCALL_INIT, SRF_IS_FIRSTCALL, SRF_PERCALL_SETUP, SRF_RETURN_DONE, SRF_RETURN_NEXT, TEXTOID, timestamp2tm(), tm2interval(), pg_tm::tm_isdst, pg_tm::tm_sec, FuncCallContext::tuple_desc, TupleDescInitEntry(), FuncCallContext::user_fctx, and values.

{
    MemoryContext oldcontext;
    FuncCallContext *funcctx;
    pg_tzenum  *tzenum;
    pg_tz      *tz;
    Datum       result;
    HeapTuple   tuple;
    Datum       values[4];
    bool        nulls[4];
    int         tzoff;
    struct pg_tm tm;
    fsec_t      fsec;
    const char *tzn;
    Interval   *resInterval;
    struct pg_tm itm;

    /* stuff done only on the first call of the function */
    if (SRF_IS_FIRSTCALL())
    {
        TupleDesc   tupdesc;

        /* create a function context for cross-call persistence */
        funcctx = SRF_FIRSTCALL_INIT();

        /*
         * switch to memory context appropriate for multiple function calls
         */
        oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);

        /* initialize timezone scanning code */
        tzenum = pg_tzenumerate_start();
        funcctx->user_fctx = (void *) tzenum;

        /*
         * build tupdesc for result tuples. This must match this function's
         * pg_proc entry!
         */
        tupdesc = CreateTemplateTupleDesc(4, false);
        TupleDescInitEntry(tupdesc, (AttrNumber) 1, "name",
                           TEXTOID, -1, 0);
        TupleDescInitEntry(tupdesc, (AttrNumber) 2, "abbrev",
                           TEXTOID, -1, 0);
        TupleDescInitEntry(tupdesc, (AttrNumber) 3, "utc_offset",
                           INTERVALOID, -1, 0);
        TupleDescInitEntry(tupdesc, (AttrNumber) 4, "is_dst",
                           BOOLOID, -1, 0);

        funcctx->tuple_desc = BlessTupleDesc(tupdesc);
        MemoryContextSwitchTo(oldcontext);
    }

    /* stuff done on every call of the function */
    funcctx = SRF_PERCALL_SETUP();
    tzenum = (pg_tzenum *) funcctx->user_fctx;

    /* search for another zone to display */
    for (;;)
    {
        oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
        tz = pg_tzenumerate_next(tzenum);
        MemoryContextSwitchTo(oldcontext);

        if (!tz)
        {
            pg_tzenumerate_end(tzenum);
            funcctx->user_fctx = NULL;
            SRF_RETURN_DONE(funcctx);
        }

        /* Convert now() to local time in this zone */
        if (timestamp2tm(GetCurrentTransactionStartTimestamp(),
                         &tzoff, &tm, &fsec, &tzn, tz) != 0)
            continue;           /* ignore if conversion fails */

        /* Ignore zic's rather silly "Factory" time zone */
        if (tzn && strcmp(tzn, "Local time zone must be set--see zic manual page") == 0)
            continue;

        /* Found a displayable zone */
        break;
    }

    MemSet(nulls, 0, sizeof(nulls));

    values[0] = CStringGetTextDatum(pg_get_timezone_name(tz));
    values[1] = CStringGetTextDatum(tzn ? tzn : "");

    MemSet(&itm, 0, sizeof(struct pg_tm));
    itm.tm_sec = -tzoff;
    resInterval = (Interval *) palloc(sizeof(Interval));
    tm2interval(&itm, 0, resInterval);
    values[2] = IntervalPGetDatum(resInterval);

    values[3] = BoolGetDatum(tm.tm_isdst > 0);

    tuple = heap_form_tuple(funcctx->tuple_desc, values, nulls);
    result = HeapTupleGetDatum(tuple);

    SRF_RETURN_NEXT(funcctx, result);
}

Node* TemporalTransform ( int32  max_precis,
Node node 
)

Definition at line 4180 of file datetime.c.

References FuncExpr::args, Assert, DatumGetInt32, exprTypmod(), IsA, linitial, list_length(), lsecond, and relabel_to_typmod().

Referenced by time_transform(), and timestamp_transform().

{
    FuncExpr   *expr = (FuncExpr *) node;
    Node       *ret = NULL;
    Node       *typmod;

    Assert(IsA(expr, FuncExpr));
    Assert(list_length(expr->args) >= 2);

    typmod = (Node *) lsecond(expr->args);

    if (IsA(typmod, Const) &&!((Const *) typmod)->constisnull)
    {
        Node       *source = (Node *) linitial(expr->args);
        int32       old_precis = exprTypmod(source);
        int32       new_precis = DatumGetInt32(((Const *) typmod)->constvalue);

        if (new_precis < 0 || new_precis == max_precis ||
            (old_precis >= 0 && new_precis >= old_precis))
            ret = relabel_to_typmod(source, new_precis);
    }

    return ret;
}


Variable Documentation

const int day_tab[2][13]

Definition at line 58 of file datetime.c.