PostgreSQL Source Code git master
Loading...
Searching...
No Matches
datetime.c
Go to the documentation of this file.
1/*-------------------------------------------------------------------------
2 *
3 * datetime.c
4 * Support functions for date/time types.
5 *
6 * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
7 * Portions Copyright (c) 1994, Regents of the University of California
8 *
9 *
10 * IDENTIFICATION
11 * src/backend/utils/adt/datetime.c
12 *
13 *-------------------------------------------------------------------------
14 */
15#include "postgres.h"
16
17#include <ctype.h>
18#include <limits.h>
19#include <math.h>
20
21#include "access/htup_details.h"
22#include "access/xact.h"
23#include "common/int.h"
24#include "common/string.h"
25#include "funcapi.h"
26#include "miscadmin.h"
27#include "nodes/nodeFuncs.h"
28#include "parser/scansup.h"
29#include "utils/builtins.h"
30#include "utils/date.h"
31#include "utils/datetime.h"
32#include "utils/guc.h"
33#include "utils/tuplestore.h"
34#include "utils/tzparser.h"
35
36static int DecodeNumber(int flen, char *str, bool haveTextMonth,
37 int fmask, int *tmask,
38 struct pg_tm *tm, fsec_t *fsec, bool *is2digits);
39static int DecodeNumberField(int len, char *str,
40 int fmask, int *tmask,
41 struct pg_tm *tm, fsec_t *fsec, bool *is2digits);
42static int DecodeTimeCommon(char *str, int fmask, int range,
43 int *tmask, struct pg_itm *itm);
44static int DecodeTime(char *str, int fmask, int range,
45 int *tmask, struct pg_tm *tm, fsec_t *fsec);
46static int DecodeTimeForInterval(char *str, int fmask, int range,
47 int *tmask, struct pg_itm_in *itm_in);
48static const datetkn *datebsearch(const char *key, const datetkn *base, int nel);
49static int DecodeDate(char *str, int fmask, int *tmask, bool *is2digits,
50 struct pg_tm *tm);
51static char *AppendSeconds(char *cp, int sec, fsec_t fsec,
52 int precision, bool fillzeros);
53static bool int64_multiply_add(int64 val, int64 multiplier, int64 *sum);
54static bool AdjustFractMicroseconds(double frac, int64 scale,
55 struct pg_itm_in *itm_in);
56static bool AdjustFractDays(double frac, int scale,
57 struct pg_itm_in *itm_in);
58static bool AdjustFractYears(double frac, int scale,
59 struct pg_itm_in *itm_in);
60static bool AdjustMicroseconds(int64 val, double fval, int64 scale,
61 struct pg_itm_in *itm_in);
62static bool AdjustDays(int64 val, int scale,
63 struct pg_itm_in *itm_in);
64static bool AdjustMonths(int64 val, struct pg_itm_in *itm_in);
65static bool AdjustYears(int64 val, int scale,
66 struct pg_itm_in *itm_in);
67static int DetermineTimeZoneOffsetInternal(struct pg_tm *tm, pg_tz *tzp,
68 pg_time_t *tp);
69static bool DetermineTimeZoneAbbrevOffsetInternal(pg_time_t t,
70 const char *abbr, pg_tz *tzp,
71 int *offset, int *isdst);
72static pg_tz *FetchDynamicTimeZone(TimeZoneAbbrevTable *tbl, const datetkn *tp,
73 DateTimeErrorExtra *extra);
74
75
76const int day_tab[2][13] =
77{
78 {31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31, 0},
79 {31, 29, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31, 0}
80};
81
82const char *const months[] = {"Jan", "Feb", "Mar", "Apr", "May", "Jun",
83"Jul", "Aug", "Sep", "Oct", "Nov", "Dec", NULL};
84
85const char *const days[] = {"Sunday", "Monday", "Tuesday", "Wednesday",
86"Thursday", "Friday", "Saturday", NULL};
87
88
89/*****************************************************************************
90 * PRIVATE ROUTINES *
91 *****************************************************************************/
92
93/*
94 * datetktbl holds date/time keywords.
95 *
96 * Note that this table must be strictly alphabetically ordered to allow an
97 * O(ln(N)) search algorithm to be used.
98 *
99 * The token field must be NUL-terminated; we truncate entries to TOKMAXLEN
100 * characters to fit.
101 *
102 * The static table contains no TZ, DTZ, or DYNTZ entries; rather those
103 * are loaded from configuration files and stored in zoneabbrevtbl, whose
104 * abbrevs[] field has the same format as the static datetktbl.
105 */
106static const datetkn datetktbl[] = {
107 /* token, type, value */
108 {"+infinity", RESERV, DTK_LATE}, /* same as "infinity" */
109 {EARLY, RESERV, DTK_EARLY}, /* "-infinity" reserved for "early time" */
110 {DA_D, ADBC, AD}, /* "ad" for years > 0 */
111 {"allballs", RESERV, DTK_ZULU}, /* 00:00:00 */
112 {"am", AMPM, AM},
113 {"apr", MONTH, 4},
114 {"april", MONTH, 4},
115 {"at", IGNORE_DTF, 0}, /* "at" (throwaway) */
116 {"aug", MONTH, 8},
117 {"august", MONTH, 8},
118 {DB_C, ADBC, BC}, /* "bc" for years <= 0 */
119 {"d", UNITS, DTK_DAY}, /* "day of month" for ISO input */
120 {"dec", MONTH, 12},
121 {"december", MONTH, 12},
122 {"dow", UNITS, DTK_DOW}, /* day of week */
123 {"doy", UNITS, DTK_DOY}, /* day of year */
124 {"dst", DTZMOD, SECS_PER_HOUR},
125 {EPOCH, RESERV, DTK_EPOCH}, /* "epoch" reserved for system epoch time */
126 {"feb", MONTH, 2},
127 {"february", MONTH, 2},
128 {"fri", DOW, 5},
129 {"friday", DOW, 5},
130 {"h", UNITS, DTK_HOUR}, /* "hour" */
131 {LATE, RESERV, DTK_LATE}, /* "infinity" reserved for "late time" */
132 {"isodow", UNITS, DTK_ISODOW}, /* ISO day of week, Sunday == 7 */
133 {"isoyear", UNITS, DTK_ISOYEAR}, /* year in terms of the ISO week date */
134 {"j", UNITS, DTK_JULIAN},
135 {"jan", MONTH, 1},
136 {"january", MONTH, 1},
137 {"jd", UNITS, DTK_JULIAN},
138 {"jul", MONTH, 7},
139 {"julian", UNITS, DTK_JULIAN},
140 {"july", MONTH, 7},
141 {"jun", MONTH, 6},
142 {"june", MONTH, 6},
143 {"m", UNITS, DTK_MONTH}, /* "month" for ISO input */
144 {"mar", MONTH, 3},
145 {"march", MONTH, 3},
146 {"may", MONTH, 5},
147 {"mm", UNITS, DTK_MINUTE}, /* "minute" for ISO input */
148 {"mon", DOW, 1},
149 {"monday", DOW, 1},
150 {"nov", MONTH, 11},
151 {"november", MONTH, 11},
152 {NOW, RESERV, DTK_NOW}, /* current transaction time */
153 {"oct", MONTH, 10},
154 {"october", MONTH, 10},
155 {"on", IGNORE_DTF, 0}, /* "on" (throwaway) */
156 {"pm", AMPM, PM},
157 {"s", UNITS, DTK_SECOND}, /* "seconds" for ISO input */
158 {"sat", DOW, 6},
159 {"saturday", DOW, 6},
160 {"sep", MONTH, 9},
161 {"sept", MONTH, 9},
162 {"september", MONTH, 9},
163 {"sun", DOW, 0},
164 {"sunday", DOW, 0},
165 {"t", ISOTIME, DTK_TIME}, /* Filler for ISO time fields */
166 {"thu", DOW, 4},
167 {"thur", DOW, 4},
168 {"thurs", DOW, 4},
169 {"thursday", DOW, 4},
170 {TODAY, RESERV, DTK_TODAY}, /* midnight */
171 {TOMORROW, RESERV, DTK_TOMORROW}, /* tomorrow midnight */
172 {"tue", DOW, 2},
173 {"tues", DOW, 2},
174 {"tuesday", DOW, 2},
175 {"wed", DOW, 3},
176 {"wednesday", DOW, 3},
177 {"weds", DOW, 3},
178 {"y", UNITS, DTK_YEAR}, /* "year" for ISO input */
179 {YESTERDAY, RESERV, DTK_YESTERDAY} /* yesterday midnight */
180};
181
182static const int szdatetktbl = sizeof datetktbl / sizeof datetktbl[0];
183
184/*
185 * deltatktbl: same format as datetktbl, but holds keywords used to represent
186 * time units (eg, for intervals, and for EXTRACT).
187 */
188static const datetkn deltatktbl[] = {
189 /* token, type, value */
190 {"@", IGNORE_DTF, 0}, /* postgres relative prefix */
191 {DAGO, AGO, 0}, /* "ago" indicates negative time offset */
192 {"c", UNITS, DTK_CENTURY}, /* "century" relative */
193 {"cent", UNITS, DTK_CENTURY}, /* "century" relative */
194 {"centuries", UNITS, DTK_CENTURY}, /* "centuries" relative */
195 {DCENTURY, UNITS, DTK_CENTURY}, /* "century" relative */
196 {"d", UNITS, DTK_DAY}, /* "day" relative */
197 {DDAY, UNITS, DTK_DAY}, /* "day" relative */
198 {"days", UNITS, DTK_DAY}, /* "days" relative */
199 {"dec", UNITS, DTK_DECADE}, /* "decade" relative */
200 {DDECADE, UNITS, DTK_DECADE}, /* "decade" relative */
201 {"decades", UNITS, DTK_DECADE}, /* "decades" relative */
202 {"decs", UNITS, DTK_DECADE}, /* "decades" relative */
203 {"h", UNITS, DTK_HOUR}, /* "hour" relative */
204 {DHOUR, UNITS, DTK_HOUR}, /* "hour" relative */
205 {"hours", UNITS, DTK_HOUR}, /* "hours" relative */
206 {"hr", UNITS, DTK_HOUR}, /* "hour" relative */
207 {"hrs", UNITS, DTK_HOUR}, /* "hours" relative */
208 {"m", UNITS, DTK_MINUTE}, /* "minute" relative */
209 {"microsecon", UNITS, DTK_MICROSEC}, /* "microsecond" relative */
210 {"mil", UNITS, DTK_MILLENNIUM}, /* "millennium" relative */
211 {"millennia", UNITS, DTK_MILLENNIUM}, /* "millennia" relative */
212 {DMILLENNIUM, UNITS, DTK_MILLENNIUM}, /* "millennium" relative */
213 {"millisecon", UNITS, DTK_MILLISEC}, /* relative */
214 {"mils", UNITS, DTK_MILLENNIUM}, /* "millennia" relative */
215 {"min", UNITS, DTK_MINUTE}, /* "minute" relative */
216 {"mins", UNITS, DTK_MINUTE}, /* "minutes" relative */
217 {DMINUTE, UNITS, DTK_MINUTE}, /* "minute" relative */
218 {"minutes", UNITS, DTK_MINUTE}, /* "minutes" relative */
219 {"mon", UNITS, DTK_MONTH}, /* "months" relative */
220 {"mons", UNITS, DTK_MONTH}, /* "months" relative */
221 {DMONTH, UNITS, DTK_MONTH}, /* "month" relative */
222 {"months", UNITS, DTK_MONTH},
223 {"ms", UNITS, DTK_MILLISEC},
224 {"msec", UNITS, DTK_MILLISEC},
225 {DMILLISEC, UNITS, DTK_MILLISEC},
226 {"mseconds", UNITS, DTK_MILLISEC},
227 {"msecs", UNITS, DTK_MILLISEC},
228 {"qtr", UNITS, DTK_QUARTER}, /* "quarter" relative */
229 {DQUARTER, UNITS, DTK_QUARTER}, /* "quarter" relative */
230 {"s", UNITS, DTK_SECOND},
231 {"sec", UNITS, DTK_SECOND},
232 {DSECOND, UNITS, DTK_SECOND},
233 {"seconds", UNITS, DTK_SECOND},
234 {"secs", UNITS, DTK_SECOND},
235 {DTIMEZONE, UNITS, DTK_TZ}, /* "timezone" time offset */
236 {"timezone_h", UNITS, DTK_TZ_HOUR}, /* timezone hour units */
237 {"timezone_m", UNITS, DTK_TZ_MINUTE}, /* timezone minutes units */
238 {"us", UNITS, DTK_MICROSEC}, /* "microsecond" relative */
239 {"usec", UNITS, DTK_MICROSEC}, /* "microsecond" relative */
240 {DMICROSEC, UNITS, DTK_MICROSEC}, /* "microsecond" relative */
241 {"useconds", UNITS, DTK_MICROSEC}, /* "microseconds" relative */
242 {"usecs", UNITS, DTK_MICROSEC}, /* "microseconds" relative */
243 {"w", UNITS, DTK_WEEK}, /* "week" relative */
244 {DWEEK, UNITS, DTK_WEEK}, /* "week" relative */
245 {"weeks", UNITS, DTK_WEEK}, /* "weeks" relative */
246 {"y", UNITS, DTK_YEAR}, /* "year" relative */
247 {DYEAR, UNITS, DTK_YEAR}, /* "year" relative */
248 {"years", UNITS, DTK_YEAR}, /* "years" relative */
249 {"yr", UNITS, DTK_YEAR}, /* "year" relative */
250 {"yrs", UNITS, DTK_YEAR} /* "years" relative */
251};
252
253static const int szdeltatktbl = sizeof deltatktbl / sizeof deltatktbl[0];
254
255static TimeZoneAbbrevTable *zoneabbrevtbl = NULL;
256
257/* Caches of recent lookup results in the above tables */
258
259static const datetkn *datecache[MAXDATEFIELDS] = {NULL};
260
261static const datetkn *deltacache[MAXDATEFIELDS] = {NULL};
262
263/* Cache for results of timezone abbreviation lookups */
264
265typedef struct TzAbbrevCache
266{
267 char abbrev[TOKMAXLEN + 1]; /* always NUL-terminated */
268 char ftype; /* TZ, DTZ, or DYNTZ */
269 int offset; /* GMT offset, if fixed-offset */
270 pg_tz *tz; /* relevant zone, if variable-offset */
271} TzAbbrevCache;
272
273static TzAbbrevCache tzabbrevcache[MAXDATEFIELDS];
274
275
276/*
277 * Calendar time to Julian date conversions.
278 * Julian date is commonly used in astronomical applications,
279 * since it is numerically accurate and computationally simple.
280 * The algorithms here will accurately convert between Julian day
281 * and calendar date for all non-negative Julian days
282 * (i.e. from Nov 24, -4713 on).
283 *
284 * Rewritten to eliminate overflow problems. This now allows the
285 * routines to work correctly for all Julian day counts from
286 * 0 to 2147483647 (Nov 24, -4713 to Jun 3, 5874898) assuming
287 * a 32-bit integer. Longer types should also work to the limits
288 * of their precision.
289 *
290 * Actually, date2j() will work sanely, in the sense of producing
291 * valid negative Julian dates, significantly before Nov 24, -4713.
292 * We rely on it to do so back to Nov 1, -4713; see IS_VALID_JULIAN()
293 * and associated commentary in timestamp.h.
294 */
295
296int
297date2j(int year, int month, int day)
298{
299 int julian;
300 int century;
301
302 if (month > 2)
303 {
304 month += 1;
305 year += 4800;
306 }
307 else
308 {
309 month += 13;
310 year += 4799;
311 }
312
313 century = year / 100;
314 julian = year * 365 - 32167;
315 julian += year / 4 - century + century / 4;
316 julian += 7834 * month / 256 + day;
317
318 return julian;
319} /* date2j() */
320
321void
322j2date(int jd, int *year, int *month, int *day)
323{
324 unsigned int julian;
325 unsigned int quad;
326 unsigned int extra;
327 int y;
328
329 julian = jd;
330 julian += 32044;
331 quad = julian / 146097;
332 extra = (julian - quad * 146097) * 4 + 3;
333 julian += 60 + quad * 3 + extra / 146097;
334 quad = julian / 1461;
335 julian -= quad * 1461;
336 y = julian * 4 / 1461;
337 julian = ((y != 0) ? ((julian + 305) % 365) : ((julian + 306) % 366))
338 + 123;
339 y += quad * 4;
340 *year = y - 4800;
341 quad = julian * 2141 / 65536;
342 *day = julian - 7834 * quad / 256;
343 *month = (quad + 10) % MONTHS_PER_YEAR + 1;
344} /* j2date() */
345
346
347/*
348 * j2day - convert Julian date to day-of-week (0..6 == Sun..Sat)
349 *
350 * Note: various places use the locution j2day(date - 1) to produce a
351 * result according to the convention 0..6 = Mon..Sun. This is a bit of
352 * a crock, but will work as long as the computation here is just a modulo.
353 */
354int
355j2day(int date)
356{
357 date += 1;
358 date %= 7;
359 /* Cope if division truncates towards zero, as it probably does */
360 if (date < 0)
361 date += 7;
362
363 return date;
364} /* j2day() */
365
366
367/*
368 * GetCurrentDateTime()
369 *
370 * Get the transaction start time ("now()") broken down as a struct pg_tm,
371 * converted according to the session timezone setting.
372 *
373 * This is just a convenience wrapper for GetCurrentTimeUsec, to cover the
374 * case where caller doesn't need either fractional seconds or tz offset.
375 */
376void
377GetCurrentDateTime(struct pg_tm *tm)
378{
379 fsec_t fsec;
380
381 GetCurrentTimeUsec(tm, &fsec, NULL);
382}
383
384/*
385 * GetCurrentTimeUsec()
386 *
387 * Get the transaction start time ("now()") broken down as a struct pg_tm,
388 * including fractional seconds and timezone offset. The time is converted
389 * according to the session timezone setting.
390 *
391 * Callers may pass tzp = NULL if they don't need the offset, but this does
392 * not affect the conversion behavior (unlike timestamp2tm()).
393 *
394 * Internally, we cache the result, since this could be called many times
395 * in a transaction, within which now() doesn't change.
396 */
397void
398GetCurrentTimeUsec(struct pg_tm *tm, fsec_t *fsec, int *tzp)
399{
400 TimestampTz cur_ts = GetCurrentTransactionStartTimestamp();
401
402 /*
403 * The cache key must include both current time and current timezone. By
404 * representing the timezone by just a pointer, we're assuming that
405 * distinct timezone settings could never have the same pointer value.
406 * This is true by virtue of the hashtable used inside pg_tzset();
407 * however, it might need another look if we ever allow entries in that
408 * hash to be recycled.
409 */
410 static TimestampTz cache_ts = 0;
411 static pg_tz *cache_timezone = NULL;
412 static struct pg_tm cache_tm;
413 static fsec_t cache_fsec;
414 static int cache_tz;
415
416 if (cur_ts != cache_ts || session_timezone != cache_timezone)
417 {
418 /*
419 * Make sure cache is marked invalid in case of error after partial
420 * update within timestamp2tm.
421 */
422 cache_timezone = NULL;
423
424 /*
425 * Perform the computation, storing results into cache. We do not
426 * really expect any error here, since current time surely ought to be
427 * within range, but check just for sanity's sake.
428 */
429 if (timestamp2tm(cur_ts, &cache_tz, &cache_tm, &cache_fsec,
430 NULL, session_timezone) != 0)
431 ereport(ERROR,
432 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
433 errmsg("timestamp out of range")));
434
435 /* OK, so mark the cache valid. */
436 cache_ts = cur_ts;
437 cache_timezone = session_timezone;
438 }
439
440 *tm = cache_tm;
441 *fsec = cache_fsec;
442 if (tzp != NULL)
443 *tzp = cache_tz;
444}
445
446
447/*
448 * Append seconds and fractional seconds (if any) at *cp.
449 *
450 * precision is the max number of fraction digits, fillzeros says to
451 * pad to two integral-seconds digits.
452 *
453 * Returns a pointer to the new end of string. No NUL terminator is put
454 * there; callers are responsible for NUL terminating str themselves.
455 *
456 * Note that any sign is stripped from the input sec and fsec values.
457 */
458static char *
459AppendSeconds(char *cp, int sec, fsec_t fsec, int precision, bool fillzeros)
460{
461 Assert(precision >= 0);
462
463 if (fillzeros)
464 cp = pg_ultostr_zeropad(cp, abs(sec), 2);
465 else
466 cp = pg_ultostr(cp, abs(sec));
467
468 /* fsec_t is just an int32 */
469 if (fsec != 0)
470 {
471 int32 value = abs(fsec);
472 char *end = &cp[precision + 1];
473 bool gotnonzero = false;
474
475 *cp++ = '.';
476
477 /*
478 * Append the fractional seconds part. Note that we don't want any
479 * trailing zeros here, so since we're building the number in reverse
480 * we'll skip appending zeros until we've output a non-zero digit.
481 */
482 while (precision--)
483 {
484 int32 oldval = value;
485 int32 remainder;
486
487 value /= 10;
488 remainder = oldval - value * 10;
489
490 /* check if we got a non-zero */
491 if (remainder)
492 gotnonzero = true;
493
494 if (gotnonzero)
495 cp[precision] = '0' + remainder;
496 else
497 end = &cp[precision];
498 }
499
500 /*
501 * If we still have a non-zero value then precision must have not been
502 * enough to print the number. We punt the problem to pg_ultostr(),
503 * which will generate a correct answer in the minimum valid width.
504 */
505 if (value)
506 return pg_ultostr(cp, abs(fsec));
507
508 return end;
509 }
510 else
511 return cp;
512}
513
514
515/*
516 * Variant of above that's specialized to timestamp case.
517 *
518 * Returns a pointer to the new end of string. No NUL terminator is put
519 * there; callers are responsible for NUL terminating str themselves.
520 */
521static char *
522AppendTimestampSeconds(char *cp, struct pg_tm *tm, fsec_t fsec)
523{
524 return AppendSeconds(cp, tm->tm_sec, fsec, MAX_TIMESTAMP_PRECISION, true);
525}
526
527
528/*
529 * Add val * multiplier to *sum.
530 * Returns true if successful, false on overflow.
531 */
532static bool
533int64_multiply_add(int64 val, int64 multiplier, int64 *sum)
534{
535 int64 product;
536
537 if (pg_mul_s64_overflow(val, multiplier, &product) ||
538 pg_add_s64_overflow(*sum, product, sum))
539 return false;
540 return true;
541}
542
543/*
544 * Multiply frac by scale (to produce microseconds) and add to itm_in->tm_usec.
545 * Returns true if successful, false if itm_in overflows.
546 */
547static bool
548AdjustFractMicroseconds(double frac, int64 scale,
549 struct pg_itm_in *itm_in)
550{
551 int64 usec;
552
553 /* Fast path for common case */
554 if (frac == 0)
555 return true;
556
557 /*
558 * We assume the input frac has abs value less than 1, so overflow of frac
559 * or usec is not an issue for interesting values of scale.
560 */
561 frac *= scale;
562 usec = (int64) frac;
563
564 /* Round off any fractional microsecond */
565 frac -= usec;
566 if (frac > 0.5)
567 usec++;
568 else if (frac < -0.5)
569 usec--;
570
571 return !pg_add_s64_overflow(itm_in->tm_usec, usec, &itm_in->tm_usec);
572}
573
574/*
575 * Multiply frac by scale (to produce days). Add the integral part of the
576 * result to itm_in->tm_mday, the fractional part to itm_in->tm_usec.
577 * Returns true if successful, false if itm_in overflows.
578 */
579static bool
580AdjustFractDays(double frac, int scale,
581 struct pg_itm_in *itm_in)
582{
583 int extra_days;
584
585 /* Fast path for common case */
586 if (frac == 0)
587 return true;
588
589 /*
590 * We assume the input frac has abs value less than 1, so overflow of frac
591 * or extra_days is not an issue.
592 */
593 frac *= scale;
594 extra_days = (int) frac;
595
596 /* ... but this could overflow, if tm_mday is already nonzero */
597 if (pg_add_s32_overflow(itm_in->tm_mday, extra_days, &itm_in->tm_mday))
598 return false;
599
600 /* Handle any fractional day */
601 frac -= extra_days;
602 return AdjustFractMicroseconds(frac, USECS_PER_DAY, itm_in);
603}
604
605/*
606 * Multiply frac by scale (to produce years), then further scale up to months.
607 * Add the integral part of the result to itm_in->tm_mon, discarding any
608 * fractional part.
609 * Returns true if successful, false if itm_in overflows.
610 */
611static bool
612AdjustFractYears(double frac, int scale,
613 struct pg_itm_in *itm_in)
614{
615 /*
616 * As above, we assume abs(frac) < 1, so this can't overflow for any
617 * interesting value of scale.
618 */
619 int extra_months = (int) rint(frac * scale * MONTHS_PER_YEAR);
620
621 return !pg_add_s32_overflow(itm_in->tm_mon, extra_months, &itm_in->tm_mon);
622}
623
624/*
625 * Add (val + fval) * scale to itm_in->tm_usec.
626 * Returns true if successful, false if itm_in overflows.
627 */
628static bool
629AdjustMicroseconds(int64 val, double fval, int64 scale,
630 struct pg_itm_in *itm_in)
631{
632 /* Handle the integer part */
633 if (!int64_multiply_add(val, scale, &itm_in->tm_usec))
634 return false;
635 /* Handle the float part */
636 return AdjustFractMicroseconds(fval, scale, itm_in);
637}
638
639/*
640 * Multiply val by scale (to produce days) and add to itm_in->tm_mday.
641 * Returns true if successful, false if itm_in overflows.
642 */
643static bool
644AdjustDays(int64 val, int scale, struct pg_itm_in *itm_in)
645{
646 int days;
647
648 if (val < INT_MIN || val > INT_MAX)
649 return false;
650 return !pg_mul_s32_overflow((int32) val, scale, &days) &&
651 !pg_add_s32_overflow(itm_in->tm_mday, days, &itm_in->tm_mday);
652}
653
654/*
655 * Add val to itm_in->tm_mon (no need for scale here, as val is always
656 * in months already).
657 * Returns true if successful, false if itm_in overflows.
658 */
659static bool
660AdjustMonths(int64 val, struct pg_itm_in *itm_in)
661{
662 if (val < INT_MIN || val > INT_MAX)
663 return false;
664 return !pg_add_s32_overflow(itm_in->tm_mon, (int32) val, &itm_in->tm_mon);
665}
666
667/*
668 * Multiply val by scale (to produce years) and add to itm_in->tm_year.
669 * Returns true if successful, false if itm_in overflows.
670 */
671static bool
672AdjustYears(int64 val, int scale,
673 struct pg_itm_in *itm_in)
674{
675 int years;
676
677 if (val < INT_MIN || val > INT_MAX)
678 return false;
679 return !pg_mul_s32_overflow((int32) val, scale, &years) &&
680 !pg_add_s32_overflow(itm_in->tm_year, years, &itm_in->tm_year);
681}
682
683
684/*
685 * Parse the fractional part of a number (decimal point and optional digits,
686 * followed by end of string). Returns the fractional value into *frac.
687 *
688 * Returns 0 if successful, DTERR code if bogus input detected.
689 */
690static int
691ParseFraction(char *cp, double *frac)
692{
693 /* Caller should always pass the start of the fraction part */
694 Assert(*cp == '.');
695
696 /*
697 * We want to allow just "." with no digits, but some versions of strtod
698 * will report EINVAL for that, so special-case it.
699 */
700 if (cp[1] == '\0')
701 {
702 *frac = 0;
703 }
704 else
705 {
706 /*
707 * On the other hand, let's reject anything that's not digits after
708 * the ".". strtod is happy with input like ".123e9", but that'd
709 * break callers' expectation that the result is in 0..1. (It's quite
710 * difficult to get here with such input, but not impossible.)
711 */
712 if (strspn(cp + 1, "0123456789") != strlen(cp + 1))
713 return DTERR_BAD_FORMAT;
714
715 errno = 0;
716 *frac = strtod(cp, &cp);
717 /* check for parse failure (probably redundant given prior check) */
718 if (*cp != '\0' || errno != 0)
719 return DTERR_BAD_FORMAT;
720 }
721 return 0;
722}
723
724/*
725 * Fetch a fractional-second value with suitable error checking.
726 * Same as ParseFraction except we convert the result to integer microseconds.
727 */
728static int
729ParseFractionalSecond(char *cp, fsec_t *fsec)
730{
731 double frac;
732 int dterr;
733
734 dterr = ParseFraction(cp, &frac);
735 if (dterr)
736 return dterr;
737 *fsec = rint(frac * 1000000);
738 return 0;
739}
740
741
742/* ParseDateTime()
743 * Break string into tokens based on a date/time context.
744 * Returns 0 if successful, DTERR code if bogus input detected.
745 *
746 * timestr - the input string
747 * workbuf - workspace for field string storage. This must be
748 * larger than the largest legal input for this datetime type --
749 * some additional space will be needed to NUL terminate fields.
750 * buflen - the size of workbuf
751 * field[] - pointers to field strings are returned in this array
752 * ftype[] - field type indicators are returned in this array
753 * maxfields - dimensions of the above two arrays
754 * *numfields - set to the actual number of fields detected
755 *
756 * The fields extracted from the input are stored as separate,
757 * null-terminated strings in the workspace at workbuf. Any text is
758 * converted to lower case.
759 *
760 * Several field types are assigned:
761 * DTK_NUMBER - digits and (possibly) a decimal point
762 * DTK_DATE - digits and two delimiters, or digits and text
763 * DTK_TIME - digits, colon delimiters, and possibly a decimal point
764 * DTK_STRING - text (no digits or punctuation)
765 * DTK_SPECIAL - leading "+" or "-" followed by text
766 * DTK_TZ - leading "+" or "-" followed by digits (also eats ':', '.', '-')
767 *
768 * Note that some field types can hold unexpected items:
769 * DTK_NUMBER can hold date fields (yy.ddd)
770 * DTK_STRING can hold months (January) and time zones (PST)
771 * DTK_DATE can hold time zone names (America/New_York, GMT-8)
772 */
773int
774ParseDateTime(const char *timestr, char *workbuf, size_t buflen,
775 char **field, int *ftype, int maxfields, int *numfields)
776{
777 int nf = 0;
778 const char *cp = timestr;
779 char *bufp = workbuf;
780 const char *bufend = workbuf + buflen;
781
782 /*
783 * Set the character pointed-to by "bufptr" to "newchar", and increment
784 * "bufptr". "end" gives the end of the buffer -- we return an error if
785 * there is no space left to append a character to the buffer. Note that
786 * "bufptr" is evaluated twice.
787 */
788#define APPEND_CHAR(bufptr, end, newchar) \
789 do \
790 { \
791 if (((bufptr) + 1) >= (end)) \
792 return DTERR_BAD_FORMAT; \
793 *(bufptr)++ = newchar; \
794 } while (0)
795
796 /* outer loop through fields */
797 while (*cp != '\0')
798 {
799 /* Ignore spaces between fields */
800 if (isspace((unsigned char) *cp))
801 {
802 cp++;
803 continue;
804 }
805
806 /* Record start of current field */
807 if (nf >= maxfields)
808 return DTERR_BAD_FORMAT;
809 field[nf] = bufp;
810
811 /* leading digit? then date or time */
812 if (isdigit((unsigned char) *cp))
813 {
814 APPEND_CHAR(bufp, bufend, *cp++);
815 while (isdigit((unsigned char) *cp))
816 APPEND_CHAR(bufp, bufend, *cp++);
817
818 /* time field? */
819 if (*cp == ':')
820 {
821 ftype[nf] = DTK_TIME;
822 APPEND_CHAR(bufp, bufend, *cp++);
823 while (isdigit((unsigned char) *cp) ||
824 (*cp == ':') || (*cp == '.'))
825 APPEND_CHAR(bufp, bufend, *cp++);
826 }
827 /* date field? allow embedded text month */
828 else if (*cp == '-' || *cp == '/' || *cp == '.')
829 {
830 /* save delimiting character to use later */
831 char delim = *cp;
832
833 APPEND_CHAR(bufp, bufend, *cp++);
834 /* second field is all digits? then no embedded text month */
835 if (isdigit((unsigned char) *cp))
836 {
837 ftype[nf] = ((delim == '.') ? DTK_NUMBER : DTK_DATE);
838 while (isdigit((unsigned char) *cp))
839 APPEND_CHAR(bufp, bufend, *cp++);
840
841 /*
842 * insist that the delimiters match to get a three-field
843 * date.
844 */
845 if (*cp == delim)
846 {
847 ftype[nf] = DTK_DATE;
848 APPEND_CHAR(bufp, bufend, *cp++);
849 while (isdigit((unsigned char) *cp) || *cp == delim)
850 APPEND_CHAR(bufp, bufend, *cp++);
851 }
852 }
853 else
854 {
855 ftype[nf] = DTK_DATE;
856 while (isalnum((unsigned char) *cp) || *cp == delim)
857 APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
858 }
859 }
860
861 /*
862 * otherwise, number only and will determine year, month, day, or
863 * concatenated fields later...
864 */
865 else
866 ftype[nf] = DTK_NUMBER;
867 }
868 /* Leading decimal point? Then fractional seconds... */
869 else if (*cp == '.')
870 {
871 APPEND_CHAR(bufp, bufend, *cp++);
872 while (isdigit((unsigned char) *cp))
873 APPEND_CHAR(bufp, bufend, *cp++);
874
875 ftype[nf] = DTK_NUMBER;
876 }
877
878 /*
879 * text? then date string, month, day of week, special, or timezone
880 */
881 else if (isalpha((unsigned char) *cp))
882 {
883 bool is_date;
884
885 ftype[nf] = DTK_STRING;
886 APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
887 while (isalpha((unsigned char) *cp))
888 APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
889
890 /*
891 * Dates can have embedded '-', '/', or '.' separators. It could
892 * also be a timezone name containing embedded '/', '+', '-', '_',
893 * or ':' (but '_' or ':' can't be the first punctuation). If the
894 * next character is a digit or '+', we need to check whether what
895 * we have so far is a recognized non-timezone keyword --- if so,
896 * don't believe that this is the start of a timezone.
897 */
898 is_date = false;
899 if (*cp == '-' || *cp == '/' || *cp == '.')
900 is_date = true;
901 else if (*cp == '+' || isdigit((unsigned char) *cp))
902 {
903 *bufp = '\0'; /* null-terminate current field value */
904 /* we need search only the core token table, not TZ names */
905 if (datebsearch(field[nf], datetktbl, szdatetktbl) == NULL)
906 is_date = true;
907 }
908 if (is_date)
909 {
910 ftype[nf] = DTK_DATE;
911 do
912 {
913 APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
914 } while (*cp == '+' || *cp == '-' ||
915 *cp == '/' || *cp == '_' ||
916 *cp == '.' || *cp == ':' ||
917 isalnum((unsigned char) *cp));
918 }
919 }
920 /* sign? then special or numeric timezone */
921 else if (*cp == '+' || *cp == '-')
922 {
923 APPEND_CHAR(bufp, bufend, *cp++);
924 /* soak up leading whitespace */
925 while (isspace((unsigned char) *cp))
926 cp++;
927 /* numeric timezone? */
928 /* note that "DTK_TZ" could also be a signed float or yyyy-mm */
929 if (isdigit((unsigned char) *cp))
930 {
931 ftype[nf] = DTK_TZ;
932 APPEND_CHAR(bufp, bufend, *cp++);
933 while (isdigit((unsigned char) *cp) ||
934 *cp == ':' || *cp == '.' || *cp == '-')
935 APPEND_CHAR(bufp, bufend, *cp++);
936 }
937 /* special? */
938 else if (isalpha((unsigned char) *cp))
939 {
940 ftype[nf] = DTK_SPECIAL;
941 APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
942 while (isalpha((unsigned char) *cp))
943 APPEND_CHAR(bufp, bufend, pg_tolower((unsigned char) *cp++));
944 }
945 /* otherwise something wrong... */
946 else
947 return DTERR_BAD_FORMAT;
948 }
949 /* ignore other punctuation but use as delimiter */
950 else if (ispunct((unsigned char) *cp))
951 {
952 cp++;
953 continue;
954 }
955 /* otherwise, something is not right... */
956 else
957 return DTERR_BAD_FORMAT;
958
959 /* force in a delimiter after each field */
960 *bufp++ = '\0';
961 nf++;
962 }
963
964 *numfields = nf;
965
966 return 0;
967}
968
969
970/* DecodeDateTime()
971 * Interpret previously parsed fields for general date and time.
972 * Return 0 if full date, 1 if only time, and negative DTERR code if problems.
973 * (Currently, all callers treat 1 as an error return too.)
974 *
975 * Inputs are field[] and ftype[] arrays, of length nf.
976 * Other arguments are outputs.
977 *
978 * External format(s):
979 * "<weekday> <month>-<day>-<year> <hour>:<minute>:<second>"
980 * "Fri Feb-7-1997 15:23:27"
981 * "Feb-7-1997 15:23:27"
982 * "2-7-1997 15:23:27"
983 * "1997-2-7 15:23:27"
984 * "1997.038 15:23:27" (day of year 1-366)
985 * Also supports input in compact time:
986 * "970207 152327"
987 * "97038 152327"
988 * "20011225T040506.789-07"
989 *
990 * Use the system-provided functions to get the current time zone
991 * if not specified in the input string.
992 *
993 * If the date is outside the range of pg_time_t (in practice that could only
994 * happen if pg_time_t is just 32 bits), then assume UTC time zone - thomas
995 * 1997-05-27
996 */
997int
998DecodeDateTime(char **field, int *ftype, int nf,
999 int *dtype, struct pg_tm *tm, fsec_t *fsec, int *tzp,
1000 DateTimeErrorExtra *extra)
1001{
1002 int fmask = 0,
1003 tmask,
1004 type;
1005 int ptype = 0; /* "prefix type" for ISO and Julian formats */
1006 int i;
1007 int val;
1008 int dterr;
1009 int mer = HR24;
1010 bool haveTextMonth = false;
1011 bool isjulian = false;
1012 bool is2digits = false;
1013 bool bc = false;
1014 pg_tz *namedTz = NULL;
1015 pg_tz *abbrevTz = NULL;
1016 pg_tz *valtz;
1017 char *abbrev = NULL;
1018 struct pg_tm cur_tm;
1019
1020 /*
1021 * We'll insist on at least all of the date fields, but initialize the
1022 * remaining fields in case they are not set later...
1023 */
1024 *dtype = DTK_DATE;
1025 tm->tm_hour = 0;
1026 tm->tm_min = 0;
1027 tm->tm_sec = 0;
1028 *fsec = 0;
1029 /* don't know daylight savings time status apriori */
1030 tm->tm_isdst = -1;
1031 if (tzp != NULL)
1032 *tzp = 0;
1033
1034 for (i = 0; i < nf; i++)
1035 {
1036 switch (ftype[i])
1037 {
1038 case DTK_DATE:
1039
1040 /*
1041 * Integral julian day with attached time zone? All other
1042 * forms with JD will be separated into distinct fields, so we
1043 * handle just this case here.
1044 */
1045 if (ptype == DTK_JULIAN)
1046 {
1047 char *cp;
1048 int jday;
1049
1050 if (tzp == NULL)
1051 return DTERR_BAD_FORMAT;
1052
1053 errno = 0;
1054 jday = strtoint(field[i], &cp, 10);
1055 if (errno == ERANGE || jday < 0)
1056 return DTERR_FIELD_OVERFLOW;
1057
1058 j2date(jday, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
1059 isjulian = true;
1060
1061 /* Get the time zone from the end of the string */
1062 dterr = DecodeTimezone(cp, tzp);
1063 if (dterr)
1064 return dterr;
1065
1066 tmask = DTK_DATE_M | DTK_TIME_M | DTK_M(TZ);
1067 ptype = 0;
1068 break;
1069 }
1070
1071 /*
1072 * Already have a date? Then this might be a time zone name
1073 * with embedded punctuation (e.g. "America/New_York") or a
1074 * run-together time with trailing time zone (e.g. hhmmss-zz).
1075 * - thomas 2001-12-25
1076 *
1077 * We consider it a time zone if we already have month & day.
1078 * This is to allow the form "mmm dd hhmmss tz year", which
1079 * we've historically accepted.
1080 */
1081 else if (ptype != 0 ||
1082 ((fmask & (DTK_M(MONTH) | DTK_M(DAY))) ==
1083 (DTK_M(MONTH) | DTK_M(DAY))))
1084 {
1085 /* No time zone accepted? Then quit... */
1086 if (tzp == NULL)
1087 return DTERR_BAD_FORMAT;
1088
1089 if (isdigit((unsigned char) *field[i]) || ptype != 0)
1090 {
1091 char *cp;
1092
1093 /*
1094 * Allow a preceding "t" field, but no other units.
1095 */
1096 if (ptype != 0)
1097 {
1098 /* Sanity check; should not fail this test */
1099 if (ptype != DTK_TIME)
1100 return DTERR_BAD_FORMAT;
1101 ptype = 0;
1102 }
1103
1104 /*
1105 * Starts with a digit but we already have a time
1106 * field? Then we are in trouble with a date and time
1107 * already...
1108 */
1109 if ((fmask & DTK_TIME_M) == DTK_TIME_M)
1110 return DTERR_BAD_FORMAT;
1111
1112 if ((cp = strchr(field[i], '-')) == NULL)
1113 return DTERR_BAD_FORMAT;
1114
1115 /* Get the time zone from the end of the string */
1116 dterr = DecodeTimezone(cp, tzp);
1117 if (dterr)
1118 return dterr;
1119 *cp = '\0';
1120
1121 /*
1122 * Then read the rest of the field as a concatenated
1123 * time
1124 */
1125 dterr = DecodeNumberField(strlen(field[i]), field[i],
1126 fmask,
1127 &tmask, tm,
1128 fsec, &is2digits);
1129 if (dterr < 0)
1130 return dterr;
1131
1132 /*
1133 * modify tmask after returning from
1134 * DecodeNumberField()
1135 */
1136 tmask |= DTK_M(TZ);
1137 }
1138 else
1139 {
1140 namedTz = pg_tzset(field[i]);
1141 if (!namedTz)
1142 {
1143 extra->dtee_timezone = field[i];
1144 return DTERR_BAD_TIMEZONE;
1145 }
1146 /* we'll apply the zone setting below */
1147 tmask = DTK_M(TZ);
1148 }
1149 }
1150 else
1151 {
1152 dterr = DecodeDate(field[i], fmask,
1153 &tmask, &is2digits, tm);
1154 if (dterr)
1155 return dterr;
1156 }
1157 break;
1158
1159 case DTK_TIME:
1160
1161 /*
1162 * This might be an ISO time following a "t" field.
1163 */
1164 if (ptype != 0)
1165 {
1166 /* Sanity check; should not fail this test */
1167 if (ptype != DTK_TIME)
1168 return DTERR_BAD_FORMAT;
1169 ptype = 0;
1170 }
1171 dterr = DecodeTime(field[i], fmask, INTERVAL_FULL_RANGE,
1172 &tmask, tm, fsec);
1173 if (dterr)
1174 return dterr;
1175
1176 /* check for time overflow */
1177 if (time_overflows(tm->tm_hour, tm->tm_min, tm->tm_sec,
1178 *fsec))
1179 return DTERR_FIELD_OVERFLOW;
1180 break;
1181
1182 case DTK_TZ:
1183 {
1184 int tz;
1185
1186 if (tzp == NULL)
1187 return DTERR_BAD_FORMAT;
1188
1189 dterr = DecodeTimezone(field[i], &tz);
1190 if (dterr)
1191 return dterr;
1192 *tzp = tz;
1193 tmask = DTK_M(TZ);
1194 }
1195 break;
1196
1197 case DTK_NUMBER:
1198
1199 /*
1200 * Deal with cases where previous field labeled this one
1201 */
1202 if (ptype != 0)
1203 {
1204 char *cp;
1205 int value;
1206
1207 errno = 0;
1208 value = strtoint(field[i], &cp, 10);
1209 if (errno == ERANGE)
1210 return DTERR_FIELD_OVERFLOW;
1211 if (*cp != '.' && *cp != '\0')
1212 return DTERR_BAD_FORMAT;
1213
1214 switch (ptype)
1215 {
1216 case DTK_JULIAN:
1217 /* previous field was a label for "julian date" */
1218 if (value < 0)
1219 return DTERR_FIELD_OVERFLOW;
1220 tmask = DTK_DATE_M;
1221 j2date(value, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
1222 isjulian = true;
1223
1224 /* fractional Julian Day? */
1225 if (*cp == '.')
1226 {
1227 double time;
1228
1229 dterr = ParseFraction(cp, &time);
1230 if (dterr)
1231 return dterr;
1232 time *= USECS_PER_DAY;
1233 dt2time(time,
1234 &tm->tm_hour, &tm->tm_min,
1235 &tm->tm_sec, fsec);
1236 tmask |= DTK_TIME_M;
1237 }
1238 break;
1239
1240 case DTK_TIME:
1241 /* previous field was "t" for ISO time */
1242 dterr = DecodeNumberField(strlen(field[i]), field[i],
1243 (fmask | DTK_DATE_M),
1244 &tmask, tm,
1245 fsec, &is2digits);
1246 if (dterr < 0)
1247 return dterr;
1248 if (tmask != DTK_TIME_M)
1249 return DTERR_BAD_FORMAT;
1250 break;
1251
1252 default:
1253 return DTERR_BAD_FORMAT;
1254 break;
1255 }
1256
1257 ptype = 0;
1258 *dtype = DTK_DATE;
1259 }
1260 else
1261 {
1262 char *cp;
1263 int flen;
1264
1265 flen = strlen(field[i]);
1266 cp = strchr(field[i], '.');
1267
1268 /* Embedded decimal and no date yet? */
1269 if (cp != NULL && !(fmask & DTK_DATE_M))
1270 {
1271 dterr = DecodeDate(field[i], fmask,
1272 &tmask, &is2digits, tm);
1273 if (dterr)
1274 return dterr;
1275 }
1276 /* embedded decimal and several digits before? */
1277 else if (cp != NULL && flen - strlen(cp) > 2)
1278 {
1279 /*
1280 * Interpret as a concatenated date or time Set the
1281 * type field to allow decoding other fields later.
1282 * Example: 20011223 or 040506
1283 */
1284 dterr = DecodeNumberField(flen, field[i], fmask,
1285 &tmask, tm,
1286 fsec, &is2digits);
1287 if (dterr < 0)
1288 return dterr;
1289 }
1290
1291 /*
1292 * Is this a YMD or HMS specification, or a year number?
1293 * YMD and HMS are required to be six digits or more, so
1294 * if it is 5 digits, it is a year. If it is six or more
1295 * digits, we assume it is YMD or HMS unless no date and
1296 * no time values have been specified. This forces 6+
1297 * digit years to be at the end of the string, or to use
1298 * the ISO date specification.
1299 */
1300 else if (flen >= 6 && (!(fmask & DTK_DATE_M) ||
1301 !(fmask & DTK_TIME_M)))
1302 {
1303 dterr = DecodeNumberField(flen, field[i], fmask,
1304 &tmask, tm,
1305 fsec, &is2digits);
1306 if (dterr < 0)
1307 return dterr;
1308 }
1309 /* otherwise it is a single date/time field... */
1310 else
1311 {
1312 dterr = DecodeNumber(flen, field[i],
1313 haveTextMonth, fmask,
1314 &tmask, tm,
1315 fsec, &is2digits);
1316 if (dterr)
1317 return dterr;
1318 }
1319 }
1320 break;
1321
1322 case DTK_STRING:
1323 case DTK_SPECIAL:
1324 /* timezone abbrevs take precedence over built-in tokens */
1325 dterr = DecodeTimezoneAbbrev(i, field[i],
1326 &type, &val, &valtz, extra);
1327 if (dterr)
1328 return dterr;
1329 if (type == UNKNOWN_FIELD)
1330 type = DecodeSpecial(i, field[i], &val);
1331 if (type == IGNORE_DTF)
1332 continue;
1333
1334 tmask = DTK_M(type);
1335 switch (type)
1336 {
1337 case RESERV:
1338 switch (val)
1339 {
1340 case DTK_NOW:
1341 tmask = (DTK_DATE_M | DTK_TIME_M | DTK_M(TZ));
1342 *dtype = DTK_DATE;
1343 GetCurrentTimeUsec(tm, fsec, tzp);
1344 break;
1345
1346 case DTK_YESTERDAY:
1347 tmask = DTK_DATE_M;
1348 *dtype = DTK_DATE;
1349 GetCurrentDateTime(&cur_tm);
1350 j2date(date2j(cur_tm.tm_year, cur_tm.tm_mon, cur_tm.tm_mday) - 1,
1351 &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
1352 break;
1353
1354 case DTK_TODAY:
1355 tmask = DTK_DATE_M;
1356 *dtype = DTK_DATE;
1357 GetCurrentDateTime(&cur_tm);
1358 tm->tm_year = cur_tm.tm_year;
1359 tm->tm_mon = cur_tm.tm_mon;
1360 tm->tm_mday = cur_tm.tm_mday;
1361 break;
1362
1363 case DTK_TOMORROW:
1364 tmask = DTK_DATE_M;
1365 *dtype = DTK_DATE;
1366 GetCurrentDateTime(&cur_tm);
1367 j2date(date2j(cur_tm.tm_year, cur_tm.tm_mon, cur_tm.tm_mday) + 1,
1368 &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
1369 break;
1370
1371 case DTK_ZULU:
1372 tmask = (DTK_TIME_M | DTK_M(TZ));
1373 *dtype = DTK_DATE;
1374 tm->tm_hour = 0;
1375 tm->tm_min = 0;
1376 tm->tm_sec = 0;
1377 if (tzp != NULL)
1378 *tzp = 0;
1379 break;
1380
1381 case DTK_EPOCH:
1382 case DTK_LATE:
1383 case DTK_EARLY:
1384 tmask = (DTK_DATE_M | DTK_TIME_M | DTK_M(TZ));
1385 *dtype = val;
1386 /* caller ignores tm for these dtype codes */
1387 break;
1388
1389 default:
1390 elog(ERROR, "unrecognized RESERV datetime token: %d",
1391 val);
1392 }
1393
1394 break;
1395
1396 case MONTH:
1397
1398 /*
1399 * already have a (numeric) month? then see if we can
1400 * substitute...
1401 */
1402 if ((fmask & DTK_M(MONTH)) && !haveTextMonth &&
1403 !(fmask & DTK_M(DAY)) && tm->tm_mon >= 1 &&
1404 tm->tm_mon <= 31)
1405 {
1406 tm->tm_mday = tm->tm_mon;
1407 tmask = DTK_M(DAY);
1408 }
1409 haveTextMonth = true;
1410 tm->tm_mon = val;
1411 break;
1412
1413 case DTZMOD:
1414
1415 /*
1416 * daylight savings time modifier (solves "MET DST"
1417 * syntax)
1418 */
1419 tmask |= DTK_M(DTZ);
1420 tm->tm_isdst = 1;
1421 if (tzp == NULL)
1422 return DTERR_BAD_FORMAT;
1423 *tzp -= val;
1424 break;
1425
1426 case DTZ:
1427
1428 /*
1429 * set mask for TZ here _or_ check for DTZ later when
1430 * getting default timezone
1431 */
1432 tmask |= DTK_M(TZ);
1433 tm->tm_isdst = 1;
1434 if (tzp == NULL)
1435 return DTERR_BAD_FORMAT;
1436 *tzp = -val;
1437 break;
1438
1439 case TZ:
1440 tm->tm_isdst = 0;
1441 if (tzp == NULL)
1442 return DTERR_BAD_FORMAT;
1443 *tzp = -val;
1444 break;
1445
1446 case DYNTZ:
1447 tmask |= DTK_M(TZ);
1448 if (tzp == NULL)
1449 return DTERR_BAD_FORMAT;
1450 /* we'll determine the actual offset later */
1451 abbrevTz = valtz;
1452 abbrev = field[i];
1453 break;
1454
1455 case AMPM:
1456 mer = val;
1457 break;
1458
1459 case ADBC:
1460 bc = (val == BC);
1461 break;
1462
1463 case DOW:
1464 tm->tm_wday = val;
1465 break;
1466
1467 case UNITS:
1468 tmask = 0;
1469 /* reject consecutive unhandled units */
1470 if (ptype != 0)
1471 return DTERR_BAD_FORMAT;
1472 ptype = val;
1473 break;
1474
1475 case ISOTIME:
1476
1477 /*
1478 * This is a filler field "t" indicating that the next
1479 * field is time. Try to verify that this is sensible.
1480 */
1481 tmask = 0;
1482
1483 /* No preceding date? Then quit... */
1484 if ((fmask & DTK_DATE_M) != DTK_DATE_M)
1485 return DTERR_BAD_FORMAT;
1486
1487 /* reject consecutive unhandled units */
1488 if (ptype != 0)
1489 return DTERR_BAD_FORMAT;
1490 ptype = val;
1491 break;
1492
1493 case UNKNOWN_FIELD:
1494
1495 /*
1496 * Before giving up and declaring error, check to see
1497 * if it is an all-alpha timezone name.
1498 */
1499 namedTz = pg_tzset(field[i]);
1500 if (!namedTz)
1501 return DTERR_BAD_FORMAT;
1502 /* we'll apply the zone setting below */
1503 tmask = DTK_M(TZ);
1504 break;
1505
1506 default:
1507 return DTERR_BAD_FORMAT;
1508 }
1509 break;
1510
1511 default:
1512 return DTERR_BAD_FORMAT;
1513 }
1514
1515 if (tmask & fmask)
1516 return DTERR_BAD_FORMAT;
1517 fmask |= tmask;
1518 } /* end loop over fields */
1519
1520 /* reject if prefix type appeared and was never handled */
1521 if (ptype != 0)
1522 return DTERR_BAD_FORMAT;
1523
1524 /* do additional checking for normal date specs (but not "infinity" etc) */
1525 if (*dtype == DTK_DATE)
1526 {
1527 /* do final checking/adjustment of Y/M/D fields */
1528 dterr = ValidateDate(fmask, isjulian, is2digits, bc, tm);
1529 if (dterr)
1530 return dterr;
1531
1532 /* handle AM/PM */
1533 if (mer != HR24 && tm->tm_hour > HOURS_PER_DAY / 2)
1534 return DTERR_FIELD_OVERFLOW;
1535 if (mer == AM && tm->tm_hour == HOURS_PER_DAY / 2)
1536 tm->tm_hour = 0;
1537 else if (mer == PM && tm->tm_hour != HOURS_PER_DAY / 2)
1538 tm->tm_hour += HOURS_PER_DAY / 2;
1539
1540 /* check for incomplete input */
1541 if ((fmask & DTK_DATE_M) != DTK_DATE_M)
1542 {
1543 if ((fmask & DTK_TIME_M) == DTK_TIME_M)
1544 return 1;
1545 return DTERR_BAD_FORMAT;
1546 }
1547
1548 /*
1549 * If we had a full timezone spec, compute the offset (we could not do
1550 * it before, because we need the date to resolve DST status).
1551 */
1552 if (namedTz != NULL)
1553 {
1554 /* daylight savings time modifier disallowed with full TZ */
1555 if (fmask & DTK_M(DTZMOD))
1556 return DTERR_BAD_FORMAT;
1557
1558 *tzp = DetermineTimeZoneOffset(tm, namedTz);
1559 }
1560
1561 /*
1562 * Likewise, if we had a dynamic timezone abbreviation, resolve it
1563 * now.
1564 */
1565 if (abbrevTz != NULL)
1566 {
1567 /* daylight savings time modifier disallowed with dynamic TZ */
1568 if (fmask & DTK_M(DTZMOD))
1569 return DTERR_BAD_FORMAT;
1570
1571 *tzp = DetermineTimeZoneAbbrevOffset(tm, abbrev, abbrevTz);
1572 }
1573
1574 /* timezone not specified? then use session timezone */
1575 if (tzp != NULL && !(fmask & DTK_M(TZ)))
1576 {
1577 /*
1578 * daylight savings time modifier but no standard timezone? then
1579 * error
1580 */
1581 if (fmask & DTK_M(DTZMOD))
1582 return DTERR_BAD_FORMAT;
1583
1584 *tzp = DetermineTimeZoneOffset(tm, session_timezone);
1585 }
1586 }
1587
1588 return 0;
1589}
1590
1591
1592/* DetermineTimeZoneOffset()
1593 *
1594 * Given a struct pg_tm in which tm_year, tm_mon, tm_mday, tm_hour, tm_min,
1595 * and tm_sec fields are set, and a zic-style time zone definition, determine
1596 * the applicable GMT offset and daylight-savings status at that time.
1597 * Set the struct pg_tm's tm_isdst field accordingly, and return the GMT
1598 * offset as the function result.
1599 *
1600 * Note: if the date is out of the range we can deal with, we return zero
1601 * as the GMT offset and set tm_isdst = 0. We don't throw an error here,
1602 * though probably some higher-level code will.
1603 */
1604int
1605DetermineTimeZoneOffset(struct pg_tm *tm, pg_tz *tzp)
1606{
1607 pg_time_t t;
1608
1609 return DetermineTimeZoneOffsetInternal(tm, tzp, &t);
1610}
1611
1612
1613/* DetermineTimeZoneOffsetInternal()
1614 *
1615 * As above, but also return the actual UTC time imputed to the date/time
1616 * into *tp.
1617 *
1618 * In event of an out-of-range date, we punt by returning zero into *tp.
1619 * This is okay for the immediate callers but is a good reason for not
1620 * exposing this worker function globally.
1621 *
1622 * Note: it might seem that we should use mktime() for this, but bitter
1623 * experience teaches otherwise. This code is much faster than most versions
1624 * of mktime(), anyway.
1625 */
1626static int
1627DetermineTimeZoneOffsetInternal(struct pg_tm *tm, pg_tz *tzp, pg_time_t *tp)
1628{
1629 int date,
1630 sec;
1631 pg_time_t day,
1632 mytime,
1633 prevtime,
1634 boundary,
1635 beforetime,
1636 aftertime;
1637 long int before_gmtoff,
1638 after_gmtoff;
1639 int before_isdst,
1640 after_isdst;
1641 int res;
1642
1643 /*
1644 * First, generate the pg_time_t value corresponding to the given
1645 * y/m/d/h/m/s taken as GMT time. If this overflows, punt and decide the
1646 * timezone is GMT. (For a valid Julian date, integer overflow should be
1647 * impossible with 64-bit pg_time_t, but let's check for safety.)
1648 */
1649 if (!IS_VALID_JULIAN(tm->tm_year, tm->tm_mon, tm->tm_mday))
1650 goto overflow;
1651 date = date2j(tm->tm_year, tm->tm_mon, tm->tm_mday) - UNIX_EPOCH_JDATE;
1652
1653 day = ((pg_time_t) date) * SECS_PER_DAY;
1654 if (day / SECS_PER_DAY != date)
1655 goto overflow;
1656 sec = tm->tm_sec + (tm->tm_min + tm->tm_hour * MINS_PER_HOUR) * SECS_PER_MINUTE;
1657 mytime = day + sec;
1658 /* since sec >= 0, overflow could only be from +day to -mytime */
1659 if (mytime < 0 && day > 0)
1660 goto overflow;
1661
1662 /*
1663 * Find the DST time boundary just before or following the target time. We
1664 * assume that all zones have GMT offsets less than 24 hours, and that DST
1665 * boundaries can't be closer together than 48 hours, so backing up 24
1666 * hours and finding the "next" boundary will work.
1667 */
1668 prevtime = mytime - SECS_PER_DAY;
1669 if (mytime < 0 && prevtime > 0)
1670 goto overflow;
1671
1672 res = pg_next_dst_boundary(&prevtime,
1673 &before_gmtoff, &before_isdst,
1674 &boundary,
1675 &after_gmtoff, &after_isdst,
1676 tzp);
1677 if (res < 0)
1678 goto overflow; /* failure? */
1679
1680 if (res == 0)
1681 {
1682 /* Non-DST zone, life is simple */
1683 tm->tm_isdst = before_isdst;
1684 *tp = mytime - before_gmtoff;
1685 return -(int) before_gmtoff;
1686 }
1687
1688 /*
1689 * Form the candidate pg_time_t values with local-time adjustment
1690 */
1691 beforetime = mytime - before_gmtoff;
1692 if ((before_gmtoff > 0 &&
1693 mytime < 0 && beforetime > 0) ||
1694 (before_gmtoff <= 0 &&
1695 mytime > 0 && beforetime < 0))
1696 goto overflow;
1697 aftertime = mytime - after_gmtoff;
1698 if ((after_gmtoff > 0 &&
1699 mytime < 0 && aftertime > 0) ||
1700 (after_gmtoff <= 0 &&
1701 mytime > 0 && aftertime < 0))
1702 goto overflow;
1703
1704 /*
1705 * If both before or both after the boundary time, we know what to do. The
1706 * boundary time itself is considered to be after the transition, which
1707 * means we can accept aftertime == boundary in the second case.
1708 */
1709 if (beforetime < boundary && aftertime < boundary)
1710 {
1711 tm->tm_isdst = before_isdst;
1712 *tp = beforetime;
1713 return -(int) before_gmtoff;
1714 }
1715 if (beforetime > boundary && aftertime >= boundary)
1716 {
1717 tm->tm_isdst = after_isdst;
1718 *tp = aftertime;
1719 return -(int) after_gmtoff;
1720 }
1721
1722 /*
1723 * It's an invalid or ambiguous time due to timezone transition. In a
1724 * spring-forward transition, prefer the "before" interpretation; in a
1725 * fall-back transition, prefer "after". (We used to define and implement
1726 * this test as "prefer the standard-time interpretation", but that rule
1727 * does not help to resolve the behavior when both times are reported as
1728 * standard time; which does happen, eg Europe/Moscow in Oct 2014. Also,
1729 * in some zones such as Europe/Dublin, there is widespread confusion
1730 * about which time offset is "standard" time, so it's fortunate that our
1731 * behavior doesn't depend on that.)
1732 */
1733 if (beforetime > aftertime)
1734 {
1735 tm->tm_isdst = before_isdst;
1736 *tp = beforetime;
1737 return -(int) before_gmtoff;
1738 }
1739 tm->tm_isdst = after_isdst;
1740 *tp = aftertime;
1741 return -(int) after_gmtoff;
1742
1743overflow:
1744 /* Given date is out of range, so assume UTC */
1745 tm->tm_isdst = 0;
1746 *tp = 0;
1747 return 0;
1748}
1749
1750
1751/* DetermineTimeZoneAbbrevOffset()
1752 *
1753 * Determine the GMT offset and DST flag to be attributed to a dynamic
1754 * time zone abbreviation, that is one whose meaning has changed over time.
1755 * *tm contains the local time at which the meaning should be determined,
1756 * and tm->tm_isdst receives the DST flag.
1757 *
1758 * This differs from the behavior of DetermineTimeZoneOffset() in that a
1759 * standard-time or daylight-time abbreviation forces use of the corresponding
1760 * GMT offset even when the zone was then in DS or standard time respectively.
1761 * (However, that happens only if we can match the given abbreviation to some
1762 * abbreviation that appears in the IANA timezone data. Otherwise, we fall
1763 * back to doing DetermineTimeZoneOffset().)
1764 */
1765int
1766DetermineTimeZoneAbbrevOffset(struct pg_tm *tm, const char *abbr, pg_tz *tzp)
1767{
1768 pg_time_t t;
1769 int zone_offset;
1770 int abbr_offset;
1771 int abbr_isdst;
1772
1773 /*
1774 * Compute the UTC time we want to probe at. (In event of overflow, we'll
1775 * probe at the epoch, which is a bit random but probably doesn't matter.)
1776 */
1777 zone_offset = DetermineTimeZoneOffsetInternal(tm, tzp, &t);
1778
1779 /*
1780 * Try to match the abbreviation to something in the zone definition.
1781 */
1782 if (DetermineTimeZoneAbbrevOffsetInternal(t, abbr, tzp,
1783 &abbr_offset, &abbr_isdst))
1784 {
1785 /* Success, so use the abbrev-specific answers. */
1786 tm->tm_isdst = abbr_isdst;
1787 return abbr_offset;
1788 }
1789
1790 /*
1791 * No match, so use the answers we already got from
1792 * DetermineTimeZoneOffsetInternal.
1793 */
1794 return zone_offset;
1795}
1796
1797
1798/* DetermineTimeZoneAbbrevOffsetTS()
1799 *
1800 * As above but the probe time is specified as a TimestampTz (hence, UTC time),
1801 * and DST status is returned into *isdst rather than into tm->tm_isdst.
1802 */
1803int
1804DetermineTimeZoneAbbrevOffsetTS(TimestampTz ts, const char *abbr,
1805 pg_tz *tzp, int *isdst)
1806{
1807 pg_time_t t = timestamptz_to_time_t(ts);
1808 int zone_offset;
1809 int abbr_offset;
1810 int tz;
1811 struct pg_tm tm;
1812 fsec_t fsec;
1813
1814 /*
1815 * If the abbrev matches anything in the zone data, this is pretty easy.
1816 */
1817 if (DetermineTimeZoneAbbrevOffsetInternal(t, abbr, tzp,
1818 &abbr_offset, isdst))
1819 return abbr_offset;
1820
1821 /*
1822 * Else, break down the timestamp so we can use DetermineTimeZoneOffset.
1823 */
1824 if (timestamp2tm(ts, &tz, &tm, &fsec, NULL, tzp) != 0)
1825 ereport(ERROR,
1826 (errcode(ERRCODE_DATETIME_VALUE_OUT_OF_RANGE),
1827 errmsg("timestamp out of range")));
1828
1829 zone_offset = DetermineTimeZoneOffset(&tm, tzp);
1830 *isdst = tm.tm_isdst;
1831 return zone_offset;
1832}
1833
1834
1835/* DetermineTimeZoneAbbrevOffsetInternal()
1836 *
1837 * Workhorse for above two functions: work from a pg_time_t probe instant.
1838 * On success, return GMT offset and DST status into *offset and *isdst.
1839 */
1840static bool
1841DetermineTimeZoneAbbrevOffsetInternal(pg_time_t t, const char *abbr, pg_tz *tzp,
1842 int *offset, int *isdst)
1843{
1844 char upabbr[TZ_STRLEN_MAX + 1];
1845 unsigned char *p;
1846 long int gmtoff;
1847
1848 /* We need to force the abbrev to upper case */
1849 strlcpy(upabbr, abbr, sizeof(upabbr));
1850 for (p = (unsigned char *) upabbr; *p; p++)
1851 *p = pg_toupper(*p);
1852
1853 /* Look up the abbrev's meaning at this time in this zone */
1854 if (pg_interpret_timezone_abbrev(upabbr,
1855 &t,
1856 &gmtoff,
1857 isdst,
1858 tzp))
1859 {
1860 /* Change sign to agree with DetermineTimeZoneOffset() */
1861 *offset = (int) -gmtoff;
1862 return true;
1863 }
1864 return false;
1865}
1866
1867
1868/* TimeZoneAbbrevIsKnown()
1869 *
1870 * Detect whether the given string is a time zone abbreviation that's known
1871 * in the specified TZDB timezone, and if so whether it's fixed or varying
1872 * meaning. The match is not case-sensitive.
1873 */
1874static bool
1875TimeZoneAbbrevIsKnown(const char *abbr, pg_tz *tzp,
1876 bool *isfixed, int *offset, int *isdst)
1877{
1878 char upabbr[TZ_STRLEN_MAX + 1];
1879 unsigned char *p;
1880 long int gmtoff;
1881
1882 /* We need to force the abbrev to upper case */
1883 strlcpy(upabbr, abbr, sizeof(upabbr));
1884 for (p = (unsigned char *) upabbr; *p; p++)
1885 *p = pg_toupper(*p);
1886
1887 /* Look up the abbrev's meaning in this zone */
1888 if (pg_timezone_abbrev_is_known(upabbr,
1889 isfixed,
1890 &gmtoff,
1891 isdst,
1892 tzp))
1893 {
1894 /* Change sign to agree with DetermineTimeZoneOffset() */
1895 *offset = (int) -gmtoff;
1896 return true;
1897 }
1898 return false;
1899}
1900
1901
1902/* DecodeTimeOnly()
1903 * Interpret parsed string as time fields only.
1904 * Returns 0 if successful, DTERR code if bogus input detected.
1905 *
1906 * Inputs are field[] and ftype[] arrays, of length nf.
1907 * Other arguments are outputs.
1908 *
1909 * Note that support for time zone is here for
1910 * SQL TIME WITH TIME ZONE, but it reveals
1911 * bogosity with SQL date/time standards, since
1912 * we must infer a time zone from current time.
1913 * - thomas 2000-03-10
1914 * Allow specifying date to get a better time zone,
1915 * if time zones are allowed. - thomas 2001-12-26
1916 */
1917int
1918DecodeTimeOnly(char **field, int *ftype, int nf,
1919 int *dtype, struct pg_tm *tm, fsec_t *fsec, int *tzp,
1920 DateTimeErrorExtra *extra)
1921{
1922 int fmask = 0,
1923 tmask,
1924 type;
1925 int ptype = 0; /* "prefix type" for ISO and Julian formats */
1926 int i;
1927 int val;
1928 int dterr;
1929 bool isjulian = false;
1930 bool is2digits = false;
1931 bool bc = false;
1932 int mer = HR24;
1933 pg_tz *namedTz = NULL;
1934 pg_tz *abbrevTz = NULL;
1935 char *abbrev = NULL;
1936 pg_tz *valtz;
1937
1938 *dtype = DTK_TIME;
1939 tm->tm_hour = 0;
1940 tm->tm_min = 0;
1941 tm->tm_sec = 0;
1942 *fsec = 0;
1943 /* don't know daylight savings time status apriori */
1944 tm->tm_isdst = -1;
1945
1946 if (tzp != NULL)
1947 *tzp = 0;
1948
1949 for (i = 0; i < nf; i++)
1950 {
1951 switch (ftype[i])
1952 {
1953 case DTK_DATE:
1954
1955 /*
1956 * Time zone not allowed? Then should not accept dates or time
1957 * zones no matter what else!
1958 */
1959 if (tzp == NULL)
1960 return DTERR_BAD_FORMAT;
1961
1962 /* Under limited circumstances, we will accept a date... */
1963 if (i == 0 && nf >= 2 &&
1964 (ftype[nf - 1] == DTK_DATE || ftype[1] == DTK_TIME))
1965 {
1966 dterr = DecodeDate(field[i], fmask,
1967 &tmask, &is2digits, tm);
1968 if (dterr)
1969 return dterr;
1970 }
1971 /* otherwise, this is a time and/or time zone */
1972 else
1973 {
1974 if (isdigit((unsigned char) *field[i]))
1975 {
1976 char *cp;
1977
1978 /*
1979 * Starts with a digit but we already have a time
1980 * field? Then we are in trouble with time already...
1981 */
1982 if ((fmask & DTK_TIME_M) == DTK_TIME_M)
1983 return DTERR_BAD_FORMAT;
1984
1985 /*
1986 * Should not get here and fail. Sanity check only...
1987 */
1988 if ((cp = strchr(field[i], '-')) == NULL)
1989 return DTERR_BAD_FORMAT;
1990
1991 /* Get the time zone from the end of the string */
1992 dterr = DecodeTimezone(cp, tzp);
1993 if (dterr)
1994 return dterr;
1995 *cp = '\0';
1996
1997 /*
1998 * Then read the rest of the field as a concatenated
1999 * time
2000 */
2001 dterr = DecodeNumberField(strlen(field[i]), field[i],
2002 (fmask | DTK_DATE_M),
2003 &tmask, tm,
2004 fsec, &is2digits);
2005 if (dterr < 0)
2006 return dterr;
2007 ftype[i] = dterr;
2008
2009 tmask |= DTK_M(TZ);
2010 }
2011 else
2012 {
2013 namedTz = pg_tzset(field[i]);
2014 if (!namedTz)
2015 {
2016 extra->dtee_timezone = field[i];
2017 return DTERR_BAD_TIMEZONE;
2018 }
2019 /* we'll apply the zone setting below */
2020 ftype[i] = DTK_TZ;
2021 tmask = DTK_M(TZ);
2022 }
2023 }
2024 break;
2025
2026 case DTK_TIME:
2027
2028 /*
2029 * This might be an ISO time following a "t" field.
2030 */
2031 if (ptype != 0)
2032 {
2033 if (ptype != DTK_TIME)
2034 return DTERR_BAD_FORMAT;
2035 ptype = 0;
2036 }
2037
2038 dterr = DecodeTime(field[i], (fmask | DTK_DATE_M),
2039 INTERVAL_FULL_RANGE,
2040 &tmask, tm, fsec);
2041 if (dterr)
2042 return dterr;
2043 break;
2044
2045 case DTK_TZ:
2046 {
2047 int tz;
2048
2049 if (tzp == NULL)
2050 return DTERR_BAD_FORMAT;
2051
2052 dterr = DecodeTimezone(field[i], &tz);
2053 if (dterr)
2054 return dterr;
2055 *tzp = tz;
2056 tmask = DTK_M(TZ);
2057 }
2058 break;
2059
2060 case DTK_NUMBER:
2061
2062 /*
2063 * Deal with cases where previous field labeled this one
2064 */
2065 if (ptype != 0)
2066 {
2067 char *cp;
2068 int value;
2069
2070 errno = 0;
2071 value = strtoint(field[i], &cp, 10);
2072 if (errno == ERANGE)
2073 return DTERR_FIELD_OVERFLOW;
2074 if (*cp != '.' && *cp != '\0')
2075 return DTERR_BAD_FORMAT;
2076
2077 switch (ptype)
2078 {
2079 case DTK_JULIAN:
2080 /* previous field was a label for "julian date" */
2081 if (tzp == NULL)
2082 return DTERR_BAD_FORMAT;
2083 if (value < 0)
2084 return DTERR_FIELD_OVERFLOW;
2085 tmask = DTK_DATE_M;
2086 j2date(value, &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
2087 isjulian = true;
2088
2089 if (*cp == '.')
2090 {
2091 double time;
2092
2093 dterr = ParseFraction(cp, &time);
2094 if (dterr)
2095 return dterr;
2096 time *= USECS_PER_DAY;
2097 dt2time(time,
2098 &tm->tm_hour, &tm->tm_min,
2099 &tm->tm_sec, fsec);
2100 tmask |= DTK_TIME_M;
2101 }
2102 break;
2103
2104 case DTK_TIME:
2105 /* previous field was "t" for ISO time */
2106 dterr = DecodeNumberField(strlen(field[i]), field[i],
2107 (fmask | DTK_DATE_M),
2108 &tmask, tm,
2109 fsec, &is2digits);
2110 if (dterr < 0)
2111 return dterr;
2112 ftype[i] = dterr;
2113
2114 if (tmask != DTK_TIME_M)
2115 return DTERR_BAD_FORMAT;
2116 break;
2117
2118 default:
2119 return DTERR_BAD_FORMAT;
2120 break;
2121 }
2122
2123 ptype = 0;
2124 *dtype = DTK_DATE;
2125 }
2126 else
2127 {
2128 char *cp;
2129 int flen;
2130
2131 flen = strlen(field[i]);
2132 cp = strchr(field[i], '.');
2133
2134 /* Embedded decimal? */
2135 if (cp != NULL)
2136 {
2137 /*
2138 * Under limited circumstances, we will accept a
2139 * date...
2140 */
2141 if (i == 0 && nf >= 2 && ftype[nf - 1] == DTK_DATE)
2142 {
2143 dterr = DecodeDate(field[i], fmask,
2144 &tmask, &is2digits, tm);
2145 if (dterr)
2146 return dterr;
2147 }
2148 /* embedded decimal and several digits before? */
2149 else if (flen - strlen(cp) > 2)
2150 {
2151 /*
2152 * Interpret as a concatenated date or time Set
2153 * the type field to allow decoding other fields
2154 * later. Example: 20011223 or 040506
2155 */
2156 dterr = DecodeNumberField(flen, field[i],
2157 (fmask | DTK_DATE_M),
2158 &tmask, tm,
2159 fsec, &is2digits);
2160 if (dterr < 0)
2161 return dterr;
2162 ftype[i] = dterr;
2163 }
2164 else
2165 return DTERR_BAD_FORMAT;
2166 }
2167 else if (flen > 4)
2168 {
2169 dterr = DecodeNumberField(flen, field[i],
2170 (fmask | DTK_DATE_M),
2171 &tmask, tm,
2172 fsec, &is2digits);
2173 if (dterr < 0)
2174 return dterr;
2175 ftype[i] = dterr;
2176 }
2177 /* otherwise it is a single date/time field... */
2178 else
2179 {
2180 dterr = DecodeNumber(flen, field[i],
2181 false,
2182 (fmask | DTK_DATE_M),
2183 &tmask, tm,
2184 fsec, &is2digits);
2185 if (dterr)
2186 return dterr;
2187 }
2188 }
2189 break;
2190
2191 case DTK_STRING:
2192 case DTK_SPECIAL:
2193 /* timezone abbrevs take precedence over built-in tokens */
2194 dterr = DecodeTimezoneAbbrev(i, field[i],
2195 &type, &val, &valtz, extra);
2196 if (dterr)
2197 return dterr;
2198 if (type == UNKNOWN_FIELD)
2199 type = DecodeSpecial(i, field[i], &val);
2200 if (type == IGNORE_DTF)
2201 continue;
2202
2203 tmask = DTK_M(type);
2204 switch (type)
2205 {
2206 case RESERV:
2207 switch (val)
2208 {
2209 case DTK_NOW:
2210 tmask = DTK_TIME_M;
2211 *dtype = DTK_TIME;
2212 GetCurrentTimeUsec(tm, fsec, NULL);
2213 break;
2214
2215 case DTK_ZULU:
2216 tmask = (DTK_TIME_M | DTK_M(TZ));
2217 *dtype = DTK_TIME;
2218 tm->tm_hour = 0;
2219 tm->tm_min = 0;
2220 tm->tm_sec = 0;
2221 tm->tm_isdst = 0;
2222 break;
2223
2224 default:
2225 return DTERR_BAD_FORMAT;
2226 }
2227
2228 break;
2229
2230 case DTZMOD:
2231
2232 /*
2233 * daylight savings time modifier (solves "MET DST"
2234 * syntax)
2235 */
2236 tmask |= DTK_M(DTZ);
2237 tm->tm_isdst = 1;
2238 if (tzp == NULL)
2239 return DTERR_BAD_FORMAT;
2240 *tzp -= val;
2241 break;
2242
2243 case DTZ:
2244
2245 /*
2246 * set mask for TZ here _or_ check for DTZ later when
2247 * getting default timezone
2248 */
2249 tmask |= DTK_M(TZ);
2250 tm->tm_isdst = 1;
2251 if (tzp == NULL)
2252 return DTERR_BAD_FORMAT;
2253 *tzp = -val;
2254 ftype[i] = DTK_TZ;
2255 break;
2256
2257 case TZ:
2258 tm->tm_isdst = 0;
2259 if (tzp == NULL)
2260 return DTERR_BAD_FORMAT;
2261 *tzp = -val;
2262 ftype[i] = DTK_TZ;
2263 break;
2264
2265 case DYNTZ:
2266 tmask |= DTK_M(TZ);
2267 if (tzp == NULL)
2268 return DTERR_BAD_FORMAT;
2269 /* we'll determine the actual offset later */
2270 abbrevTz = valtz;
2271 abbrev = field[i];
2272 ftype[i] = DTK_TZ;
2273 break;
2274
2275 case AMPM:
2276 mer = val;
2277 break;
2278
2279 case ADBC:
2280 bc = (val == BC);
2281 break;
2282
2283 case UNITS:
2284 tmask = 0;
2285 /* reject consecutive unhandled units */
2286 if (ptype != 0)
2287 return DTERR_BAD_FORMAT;
2288 ptype = val;
2289 break;
2290
2291 case ISOTIME:
2292 tmask = 0;
2293 /* reject consecutive unhandled units */
2294 if (ptype != 0)
2295 return DTERR_BAD_FORMAT;
2296 ptype = val;
2297 break;
2298
2299 case UNKNOWN_FIELD:
2300
2301 /*
2302 * Before giving up and declaring error, check to see
2303 * if it is an all-alpha timezone name.
2304 */
2305 namedTz = pg_tzset(field[i]);
2306 if (!namedTz)
2307 return DTERR_BAD_FORMAT;
2308 /* we'll apply the zone setting below */
2309 tmask = DTK_M(TZ);
2310 break;
2311
2312 default:
2313 return DTERR_BAD_FORMAT;
2314 }
2315 break;
2316
2317 default:
2318 return DTERR_BAD_FORMAT;
2319 }
2320
2321 if (tmask & fmask)
2322 return DTERR_BAD_FORMAT;
2323 fmask |= tmask;
2324 } /* end loop over fields */
2325
2326 /* reject if prefix type appeared and was never handled */
2327 if (ptype != 0)
2328 return DTERR_BAD_FORMAT;
2329
2330 /* do final checking/adjustment of Y/M/D fields */
2331 dterr = ValidateDate(fmask, isjulian, is2digits, bc, tm);
2332 if (dterr)
2333 return dterr;
2334
2335 /* handle AM/PM */
2336 if (mer != HR24 && tm->tm_hour > HOURS_PER_DAY / 2)
2337 return DTERR_FIELD_OVERFLOW;
2338 if (mer == AM && tm->tm_hour == HOURS_PER_DAY / 2)
2339 tm->tm_hour = 0;
2340 else if (mer == PM && tm->tm_hour != HOURS_PER_DAY / 2)
2341 tm->tm_hour += HOURS_PER_DAY / 2;
2342
2343 /* check for time overflow */
2344 if (time_overflows(tm->tm_hour, tm->tm_min, tm->tm_sec, *fsec))
2345 return DTERR_FIELD_OVERFLOW;
2346
2347 if ((fmask & DTK_TIME_M) != DTK_TIME_M)
2348 return DTERR_BAD_FORMAT;
2349
2350 /*
2351 * If we had a full timezone spec, compute the offset (we could not do it
2352 * before, because we may need the date to resolve DST status).
2353 */
2354 if (namedTz != NULL)
2355 {
2356 long int gmtoff;
2357
2358 /* daylight savings time modifier disallowed with full TZ */
2359 if (fmask & DTK_M(DTZMOD))
2360 return DTERR_BAD_FORMAT;
2361
2362 /* if non-DST zone, we do not need to know the date */
2363 if (pg_get_timezone_offset(namedTz, &gmtoff))
2364 {
2365 *tzp = -(int) gmtoff;
2366 }
2367 else
2368 {
2369 /* a date has to be specified */
2370 if ((fmask & DTK_DATE_M) != DTK_DATE_M)
2371 return DTERR_BAD_FORMAT;
2372 *tzp = DetermineTimeZoneOffset(tm, namedTz);
2373 }
2374 }
2375
2376 /*
2377 * Likewise, if we had a dynamic timezone abbreviation, resolve it now.
2378 */
2379 if (abbrevTz != NULL)
2380 {
2381 struct pg_tm tt,
2382 *tmp = &tt;
2383
2384 /*
2385 * daylight savings time modifier but no standard timezone? then error
2386 */
2387 if (fmask & DTK_M(DTZMOD))
2388 return DTERR_BAD_FORMAT;
2389
2390 if ((fmask & DTK_DATE_M) == 0)
2391 GetCurrentDateTime(tmp);
2392 else
2393 {
2394 /* a date has to be specified */
2395 if ((fmask & DTK_DATE_M) != DTK_DATE_M)
2396 return DTERR_BAD_FORMAT;
2397 tmp->tm_year = tm->tm_year;
2398 tmp->tm_mon = tm->tm_mon;
2399 tmp->tm_mday = tm->tm_mday;
2400 }
2401 tmp->tm_hour = tm->tm_hour;
2402 tmp->tm_min = tm->tm_min;
2403 tmp->tm_sec = tm->tm_sec;
2404 *tzp = DetermineTimeZoneAbbrevOffset(tmp, abbrev, abbrevTz);
2405 tm->tm_isdst = tmp->tm_isdst;
2406 }
2407
2408 /* timezone not specified? then use session timezone */
2409 if (tzp != NULL && !(fmask & DTK_M(TZ)))
2410 {
2411 struct pg_tm tt,
2412 *tmp = &tt;
2413
2414 /*
2415 * daylight savings time modifier but no standard timezone? then error
2416 */
2417 if (fmask & DTK_M(DTZMOD))
2418 return DTERR_BAD_FORMAT;
2419
2420 if ((fmask & DTK_DATE_M) == 0)
2421 GetCurrentDateTime(tmp);
2422 else
2423 {
2424 /* a date has to be specified */
2425 if ((fmask & DTK_DATE_M) != DTK_DATE_M)
2426 return DTERR_BAD_FORMAT;
2427 tmp->tm_year = tm->tm_year;
2428 tmp->tm_mon = tm->tm_mon;
2429 tmp->tm_mday = tm->tm_mday;
2430 }
2431 tmp->tm_hour = tm->tm_hour;
2432 tmp->tm_min = tm->tm_min;
2433 tmp->tm_sec = tm->tm_sec;
2434 *tzp = DetermineTimeZoneOffset(tmp, session_timezone);
2435 tm->tm_isdst = tmp->tm_isdst;
2436 }
2437
2438 return 0;
2439}
2440
2441/* DecodeDate()
2442 * Decode date string which includes delimiters.
2443 * Return 0 if okay, a DTERR code if not.
2444 *
2445 * str: field to be parsed
2446 * fmask: bitmask for field types already seen
2447 * *tmask: receives bitmask for fields found here
2448 * *is2digits: set to true if we find 2-digit year
2449 * *tm: field values are stored into appropriate members of this struct
2450 */
2451static int
2452DecodeDate(char *str, int fmask, int *tmask, bool *is2digits,
2453 struct pg_tm *tm)
2454{
2455 fsec_t fsec;
2456 int nf = 0;
2457 int i,
2458 len;
2459 int dterr;
2460 bool haveTextMonth = false;
2461 int type,
2462 val,
2463 dmask = 0;
2464 char *field[MAXDATEFIELDS];
2465
2466 *tmask = 0;
2467
2468 /* parse this string... */
2469 while (*str != '\0' && nf < MAXDATEFIELDS)
2470 {
2471 /* skip field separators */
2472 while (*str != '\0' && !isalnum((unsigned char) *str))
2473 str++;
2474
2475 if (*str == '\0')
2476 return DTERR_BAD_FORMAT; /* end of string after separator */
2477
2478 field[nf] = str;
2479 if (isdigit((unsigned char) *str))
2480 {
2481 while (isdigit((unsigned char) *str))
2482 str++;
2483 }
2484 else if (isalpha((unsigned char) *str))
2485 {
2486 while (isalpha((unsigned char) *str))
2487 str++;
2488 }
2489
2490 /* Just get rid of any non-digit, non-alpha characters... */
2491 if (*str != '\0')
2492 *str++ = '\0';
2493 nf++;
2494 }
2495
2496 /* look first for text fields, since that will be unambiguous month */
2497 for (i = 0; i < nf; i++)
2498 {
2499 if (isalpha((unsigned char) *field[i]))
2500 {
2501 type = DecodeSpecial(i, field[i], &val);
2502 if (type == IGNORE_DTF)
2503 continue;
2504
2505 dmask = DTK_M(type);
2506 switch (type)
2507 {
2508 case MONTH:
2509 tm->tm_mon = val;
2510 haveTextMonth = true;
2511 break;
2512
2513 default:
2514 return DTERR_BAD_FORMAT;
2515 }
2516 if (fmask & dmask)
2517 return DTERR_BAD_FORMAT;
2518
2519 fmask |= dmask;
2520 *tmask |= dmask;
2521
2522 /* mark this field as being completed */
2523 field[i] = NULL;
2524 }
2525 }
2526
2527 /* now pick up remaining numeric fields */
2528 for (i = 0; i < nf; i++)
2529 {
2530 if (field[i] == NULL)
2531 continue;
2532
2533 if ((len = strlen(field[i])) <= 0)
2534 return DTERR_BAD_FORMAT;
2535
2536 dterr = DecodeNumber(len, field[i], haveTextMonth, fmask,
2537 &dmask, tm,
2538 &fsec, is2digits);
2539 if (dterr)
2540 return dterr;
2541
2542 if (fmask & dmask)
2543 return DTERR_BAD_FORMAT;
2544
2545 fmask |= dmask;
2546 *tmask |= dmask;
2547 }
2548
2549 if ((fmask & ~(DTK_M(DOY) | DTK_M(TZ))) != DTK_DATE_M)
2550 return DTERR_BAD_FORMAT;
2551
2552 /* validation of the field values must wait until ValidateDate() */
2553
2554 return 0;
2555}
2556
2557/* ValidateDate()
2558 * Check valid year/month/day values, handle BC and DOY cases
2559 * Return 0 if okay, a DTERR code if not.
2560 */
2561int
2562ValidateDate(int fmask, bool isjulian, bool is2digits, bool bc,
2563 struct pg_tm *tm)
2564{
2565 if (fmask & DTK_M(YEAR))
2566 {
2567 if (isjulian)
2568 {
2569 /* tm_year is correct and should not be touched */
2570 }
2571 else if (bc)
2572 {
2573 /* there is no year zero in AD/BC notation */
2574 if (tm->tm_year <= 0)
2575 return DTERR_FIELD_OVERFLOW;
2576 /* internally, we represent 1 BC as year zero, 2 BC as -1, etc */
2577 tm->tm_year = -(tm->tm_year - 1);
2578 }
2579 else if (is2digits)
2580 {
2581 /* process 1 or 2-digit input as 1970-2069 AD, allow '0' and '00' */
2582 if (tm->tm_year < 0) /* just paranoia */
2583 return DTERR_FIELD_OVERFLOW;
2584 if (tm->tm_year < 70)
2585 tm->tm_year += 2000;
2586 else if (tm->tm_year < 100)
2587 tm->tm_year += 1900;
2588 }
2589 else
2590 {
2591 /* there is no year zero in AD/BC notation */
2592 if (tm->tm_year <= 0)
2593 return DTERR_FIELD_OVERFLOW;
2594 }
2595 }
2596
2597 /* now that we have correct year, decode DOY */
2598 if (fmask & DTK_M(DOY))
2599 {
2600 j2date(date2j(tm->tm_year, 1, 1) + tm->tm_yday - 1,
2601 &tm->tm_year, &tm->tm_mon, &tm->tm_mday);
2602 }
2603
2604 /* check for valid month */
2605 if (fmask & DTK_M(MONTH))
2606 {
2607 if (tm->tm_mon < 1 || tm->tm_mon > MONTHS_PER_YEAR)
2608 return DTERR_MD_FIELD_OVERFLOW;
2609 }
2610
2611 /* minimal check for valid day */
2612 if (fmask & DTK_M(DAY))
2613 {
2614 if (tm->tm_mday < 1 || tm->tm_mday > 31)
2615 return DTERR_MD_FIELD_OVERFLOW;
2616 }
2617
2618 if ((fmask & DTK_DATE_M) == DTK_DATE_M)
2619 {
2620 /*
2621 * Check for valid day of month, now that we know for sure the month
2622 * and year. Note we don't use MD_FIELD_OVERFLOW here, since it seems
2623 * unlikely that "Feb 29" is a YMD-order error.
2624 */
2625 if (tm->tm_mday > day_tab[isleap(tm->tm_year)][tm->tm_mon - 1])
2626 return DTERR_FIELD_OVERFLOW;
2627 }
2628
2629 return 0;
2630}
2631
2632
2633/* DecodeTimeCommon()
2634 * Decode time string which includes delimiters.
2635 * Return 0 if okay, a DTERR code if not.
2636 * tmask and itm are output parameters.
2637 *
2638 * This code is shared between the timestamp and interval cases.
2639 * We return a struct pg_itm (of which only the tm_usec, tm_sec, tm_min,
2640 * and tm_hour fields are used) and let the wrapper functions below
2641 * convert and range-check as necessary.
2642 */
2643static int
2644DecodeTimeCommon(char *str, int fmask, int range,
2645 int *tmask, struct pg_itm *itm)
2646{
2647 char *cp;
2648 int dterr;
2649 fsec_t fsec = 0;
2650
2651 *tmask = DTK_TIME_M;
2652
2653 errno = 0;
2654 itm->tm_hour = strtoi64(str, &cp, 10);
2655 if (errno == ERANGE)
2656 return DTERR_FIELD_OVERFLOW;
2657 if (*cp != ':')
2658 return DTERR_BAD_FORMAT;
2659 errno = 0;
2660 itm->tm_min = strtoint(cp + 1, &cp, 10);
2661 if (errno == ERANGE)
2662 return DTERR_FIELD_OVERFLOW;
2663 if (*cp == '\0')
2664 {
2665 itm->tm_sec = 0;
2666 /* If it's a MINUTE TO SECOND interval, take 2 fields as being mm:ss */
2667 if (range == (INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND)))
2668 {
2669 if (itm->tm_hour > INT_MAX || itm->tm_hour < INT_MIN)
2670 return DTERR_FIELD_OVERFLOW;
2671 itm->tm_sec = itm->tm_min;
2672 itm->tm_min = (int) itm->tm_hour;
2673 itm->tm_hour = 0;
2674 }
2675 }
2676 else if (*cp == '.')
2677 {
2678 /* always assume mm:ss.sss is MINUTE TO SECOND */
2679 dterr = ParseFractionalSecond(cp, &fsec);
2680 if (dterr)
2681 return dterr;
2682 if (itm->tm_hour > INT_MAX || itm->tm_hour < INT_MIN)
2683 return DTERR_FIELD_OVERFLOW;
2684 itm->tm_sec = itm->tm_min;
2685 itm->tm_min = (int) itm->tm_hour;
2686 itm->tm_hour = 0;
2687 }
2688 else if (*cp == ':')
2689 {
2690 errno = 0;
2691 itm->tm_sec = strtoint(cp + 1, &cp, 10);
2692 if (errno == ERANGE)
2693 return DTERR_FIELD_OVERFLOW;
2694 if (*cp == '.')
2695 {
2696 dterr = ParseFractionalSecond(cp, &fsec);
2697 if (dterr)
2698 return dterr;
2699 }
2700 else if (*cp != '\0')
2701 return DTERR_BAD_FORMAT;
2702 }
2703 else
2704 return DTERR_BAD_FORMAT;
2705
2706 /* do a sanity check; but caller must check the range of tm_hour */
2707 if (itm->tm_hour < 0 ||
2708 itm->tm_min < 0 || itm->tm_min > MINS_PER_HOUR - 1 ||
2709 itm->tm_sec < 0 || itm->tm_sec > SECS_PER_MINUTE ||
2710 fsec < 0 || fsec > USECS_PER_SEC)
2711 return DTERR_FIELD_OVERFLOW;
2712
2713 itm->tm_usec = (int) fsec;
2714
2715 return 0;
2716}
2717
2718/* DecodeTime()
2719 * Decode time string which includes delimiters.
2720 * Return 0 if okay, a DTERR code if not.
2721 *
2722 * This version is used for timestamps. The results are returned into
2723 * the tm_hour/tm_min/tm_sec fields of *tm, and microseconds into *fsec.
2724 */
2725static int
2726DecodeTime(char *str, int fmask, int range,
2727 int *tmask, struct pg_tm *tm, fsec_t *fsec)
2728{
2729 struct pg_itm itm;
2730 int dterr;
2731
2732 dterr = DecodeTimeCommon(str, fmask, range,
2733 tmask, &itm);
2734 if (dterr)
2735 return dterr;
2736
2737 if (itm.tm_hour > INT_MAX)
2738 return DTERR_FIELD_OVERFLOW;
2739 tm->tm_hour = (int) itm.tm_hour;
2740 tm->tm_min = itm.tm_min;
2741 tm->tm_sec = itm.tm_sec;
2742 *fsec = itm.tm_usec;
2743
2744 return 0;
2745}
2746
2747/* DecodeTimeForInterval()
2748 * Decode time string which includes delimiters.
2749 * Return 0 if okay, a DTERR code if not.
2750 *
2751 * This version is used for intervals. The results are returned into
2752 * itm_in->tm_usec.
2753 */
2754static int
2755DecodeTimeForInterval(char *str, int fmask, int range,
2756 int *tmask, struct pg_itm_in *itm_in)
2757{
2758 struct pg_itm itm;
2759 int dterr;
2760
2761 dterr = DecodeTimeCommon(str, fmask, range,
2762 tmask, &itm);
2763 if (dterr)
2764 return dterr;
2765
2766 itm_in->tm_usec = itm.tm_usec;
2767 if (!int64_multiply_add(itm.tm_hour, USECS_PER_HOUR, &itm_in->tm_usec) ||
2768 !int64_multiply_add(itm.tm_min, USECS_PER_MINUTE, &itm_in->tm_usec) ||
2769 !int64_multiply_add(itm.tm_sec, USECS_PER_SEC, &itm_in->tm_usec))
2770 return DTERR_FIELD_OVERFLOW;
2771
2772 return 0;
2773}
2774
2775
2776/* DecodeNumber()
2777 * Interpret plain numeric field as a date value in context.
2778 * Return 0 if okay, a DTERR code if not.
2779 */
2780static int
2781DecodeNumber(int flen, char *str, bool haveTextMonth, int fmask,
2782 int *tmask, struct pg_tm *tm, fsec_t *fsec, bool *is2digits)
2783{
2784 int val;
2785 char *cp;
2786 int dterr;
2787
2788 *tmask = 0;
2789
2790 errno = 0;
2791 val = strtoint(str, &cp, 10);
2792 if (errno == ERANGE)
2793 return DTERR_FIELD_OVERFLOW;
2794 if (cp == str)
2795 return DTERR_BAD_FORMAT;
2796
2797 if (*cp == '.')
2798 {
2799 /*
2800 * More than two digits before decimal point? Then could be a date or
2801 * a run-together time: 2001.360 20011225 040506.789
2802 */
2803 if (cp - str > 2)
2804 {
2805 dterr = DecodeNumberField(flen, str,
2806 (fmask | DTK_DATE_M),
2807 tmask, tm,
2808 fsec, is2digits);
2809 if (dterr < 0)
2810 return dterr;
2811 return 0;
2812 }
2813
2814 dterr = ParseFractionalSecond(cp, fsec);
2815 if (dterr)
2816 return dterr;
2817 }
2818 else if (*cp != '\0')
2819 return DTERR_BAD_FORMAT;
2820
2821 /* Special case for day of year */
2822 if (flen == 3 && (fmask & DTK_DATE_M) == DTK_M(YEAR) && val >= 1 &&
2823 val <= 366)
2824 {
2825 *tmask = (DTK_M(DOY) | DTK_M(MONTH) | DTK_M(DAY));
2826 tm->tm_yday = val;
2827 /* tm_mon and tm_mday can't actually be set yet ... */
2828 return 0;
2829 }
2830
2831 /* Switch based on what we have so far */
2832 switch (fmask & DTK_DATE_M)
2833 {
2834 case 0:
2835
2836 /*
2837 * Nothing so far; make a decision about what we think the input
2838 * is. There used to be lots of heuristics here, but the
2839 * consensus now is to be paranoid. It *must* be either
2840 * YYYY-MM-DD (with a more-than-two-digit year field), or the
2841 * field order defined by DateOrder.
2842 */
2843 if (flen >= 3 || DateOrder == DATEORDER_YMD)
2844 {
2845 *tmask = DTK_M(YEAR);
2846 tm->tm_year = val;
2847 }
2848 else if (DateOrder == DATEORDER_DMY)
2849 {
2850 *tmask = DTK_M(DAY);
2851 tm->tm_mday = val;
2852 }
2853 else
2854 {
2855 *tmask = DTK_M(MONTH);
2856 tm->tm_mon = val;
2857 }
2858 break;
2859
2860 case (DTK_M(YEAR)):
2861 /* Must be at second field of YY-MM-DD */
2862 *tmask = DTK_M(MONTH);
2863 tm->tm_mon = val;
2864 break;
2865
2866 case (DTK_M(MONTH)):
2867 if (haveTextMonth)
2868 {
2869 /*
2870 * We are at the first numeric field of a date that included a
2871 * textual month name. We want to support the variants
2872 * MON-DD-YYYY, DD-MON-YYYY, and YYYY-MON-DD as unambiguous
2873 * inputs. We will also accept MON-DD-YY or DD-MON-YY in
2874 * either DMY or MDY modes, as well as YY-MON-DD in YMD mode.
2875 */
2876 if (flen >= 3 || DateOrder == DATEORDER_YMD)
2877 {
2878 *tmask = DTK_M(YEAR);
2879 tm->tm_year = val;
2880 }
2881 else
2882 {
2883 *tmask = DTK_M(DAY);
2884 tm->tm_mday = val;
2885 }
2886 }
2887 else
2888 {
2889 /* Must be at second field of MM-DD-YY */
2890 *tmask = DTK_M(DAY);
2891 tm->tm_mday = val;
2892 }
2893 break;
2894
2895 case (DTK_M(YEAR) | DTK_M(MONTH)):
2896 if (haveTextMonth)
2897 {
2898 /* Need to accept DD-MON-YYYY even in YMD mode */
2899 if (flen >= 3 && *is2digits)
2900 {
2901 /* Guess that first numeric field is day was wrong */
2902 *tmask = DTK_M(DAY); /* YEAR is already set */
2903 tm->tm_mday = tm->tm_year;
2904 tm->tm_year = val;
2905 *is2digits = false;
2906 }
2907 else
2908 {
2909 *tmask = DTK_M(DAY);
2910 tm->tm_mday = val;
2911 }
2912 }
2913 else
2914 {
2915 /* Must be at third field of YY-MM-DD */
2916 *tmask = DTK_M(DAY);
2917 tm->tm_mday = val;
2918 }
2919 break;
2920
2921 case (DTK_M(DAY)):
2922 /* Must be at second field of DD-MM-YY */
2923 *tmask = DTK_M(MONTH);
2924 tm->tm_mon = val;
2925 break;
2926
2927 case (DTK_M(MONTH) | DTK_M(DAY)):
2928 /* Must be at third field of DD-MM-YY or MM-DD-YY */
2929 *tmask = DTK_M(YEAR);
2930 tm->tm_year = val;
2931 break;
2932
2933 case (DTK_M(YEAR) | DTK_M(MONTH) | DTK_M(DAY)):
2934 /* we have all the date, so it must be a time field */
2935 dterr = DecodeNumberField(flen, str, fmask,
2936 tmask, tm,
2937 fsec, is2digits);
2938 if (dterr < 0)
2939 return dterr;
2940 return 0;
2941
2942 default:
2943 /* Anything else is bogus input */
2944 return DTERR_BAD_FORMAT;
2945 }
2946
2947 /*
2948 * When processing a year field, mark it for adjustment if it's only one
2949 * or two digits.
2950 */
2951 if (*tmask == DTK_M(YEAR))
2952 *is2digits = (flen <= 2);
2953
2954 return 0;
2955}
2956
2957
2958/* DecodeNumberField()
2959 * Interpret numeric string as a concatenated date or time field.
2960 * Return a DTK token (>= 0) if successful, a DTERR code (< 0) if not.
2961 *
2962 * Use the context of previously decoded fields to help with
2963 * the interpretation.
2964 */
2965static int
2966DecodeNumberField(int len, char *str, int fmask,
2967 int *tmask, struct pg_tm *tm, fsec_t *fsec, bool *is2digits)
2968{
2969 char *cp;
2970
2971 /*
2972 * This function was originally meant to cope only with DTK_NUMBER fields,
2973 * but we now sometimes abuse it to parse (parts of) DTK_DATE fields,
2974 * which can contain letters and other punctuation. Reject if it's not a
2975 * valid DTK_NUMBER, that is digits and decimal point(s). (ParseFraction
2976 * will reject if there's more than one decimal point.)
2977 */
2978 if (strspn(str, "0123456789.") != len)
2979 return DTERR_BAD_FORMAT;
2980
2981 /*
2982 * Have a decimal point? Then this is a date or something with a seconds
2983 * field...
2984 */
2985 if ((cp = strchr(str, '.')) != NULL)
2986 {
2987 int dterr;
2988
2989 /* Convert the fraction and store at *fsec */
2990 dterr = ParseFractionalSecond(cp, fsec);
2991 if (dterr)
2992 return dterr;
2993 /* Now truncate off the fraction for further processing */
2994 *cp = '\0';
2995 len = strlen(str);
2996 }
2997 /* No decimal point and no complete date yet? */
2998 else if ((fmask & DTK_DATE_M) != DTK_DATE_M)
2999 {
3000 if (len >= 6)
3001 {
3002 *tmask = DTK_DATE_M;
3003
3004 /*
3005 * Start from end and consider first 2 as Day, next 2 as Month,
3006 * and the rest as Year.
3007 */
3008 tm->tm_mday = atoi(str + (len - 2));
3009 *(str + (len - 2)) = '\0';
3010 tm->tm_mon = atoi(str + (len - 4));
3011 *(str + (len - 4)) = '\0';
3012 tm->tm_year = atoi(str);
3013 if ((len - 4) == 2)
3014 *is2digits = true;
3015
3016 return DTK_DATE;
3017 }
3018 }
3019
3020 /* not all time fields are specified? */
3021 if ((fmask & DTK_TIME_M) != DTK_TIME_M)
3022 {
3023 /* hhmmss */
3024 if (len == 6)
3025 {
3026 *tmask = DTK_TIME_M;
3027 tm->tm_sec = atoi(str + 4);
3028 *(str + 4) = '\0';
3029 tm->tm_min = atoi(str + 2);
3030 *(str + 2) = '\0';
3031 tm->tm_hour = atoi(str);
3032
3033 return DTK_TIME;
3034 }
3035 /* hhmm? */
3036 else if (len == 4)
3037 {
3038 *tmask = DTK_TIME_M;
3039 tm->tm_sec = 0;
3040 tm->tm_min = atoi(str + 2);
3041 *(str + 2) = '\0';
3042 tm->tm_hour = atoi(str);
3043
3044 return DTK_TIME;
3045 }
3046 }
3047
3048 return DTERR_BAD_FORMAT;
3049}
3050
3051
3052/* DecodeTimezone()
3053 * Interpret string as a numeric timezone.
3054 *
3055 * Return 0 if okay (and set *tzp), a DTERR code if not okay.
3056 */
3057int
3058DecodeTimezone(const char *str, int *tzp)
3059{
3060 int tz;
3061 int hr,
3062 min,
3063 sec = 0;
3064 char *cp;
3065
3066 /* leading character must be "+" or "-" */
3067 if (*str != '+' && *str != '-')
3068 return DTERR_BAD_FORMAT;
3069
3070 errno = 0;
3071 hr = strtoint(str + 1, &cp, 10);
3072 if (errno == ERANGE)
3073 return DTERR_TZDISP_OVERFLOW;
3074
3075 /* explicit delimiter? */
3076 if (*cp == ':')
3077 {
3078 errno = 0;
3079 min = strtoint(cp + 1, &cp, 10);
3080 if (errno == ERANGE)
3081 return DTERR_TZDISP_OVERFLOW;
3082 if (*cp == ':')
3083 {
3084 errno = 0;
3085 sec = strtoint(cp + 1, &cp, 10);
3086 if (errno == ERANGE)
3087 return DTERR_TZDISP_OVERFLOW;
3088 }
3089 }
3090 /* otherwise, might have run things together... */
3091 else if (*cp == '\0' && strlen(str) > 3)
3092 {
3093 min = hr % 100;
3094 hr = hr / 100;
3095 /* we could, but don't, support a run-together hhmmss format */
3096 }
3097 else
3098 min = 0;
3099
3100 /* Range-check the values; see notes in datatype/timestamp.h */
3101 if (hr < 0 || hr > MAX_TZDISP_HOUR)
3102 return DTERR_TZDISP_OVERFLOW;
3103 if (min < 0 || min >= MINS_PER_HOUR)
3104 return DTERR_TZDISP_OVERFLOW;
3105 if (sec < 0 || sec >= SECS_PER_MINUTE)
3106 return DTERR_TZDISP_OVERFLOW;
3107
3108 tz = (hr * MINS_PER_HOUR + min) * SECS_PER_MINUTE + sec;
3109 if (*str == '-')
3110 tz = -tz;
3111
3112 *tzp = -tz;
3113
3114 if (*cp != '\0')
3115 return DTERR_BAD_FORMAT;
3116
3117 return 0;
3118}
3119
3120
3121/* DecodeTimezoneAbbrev()
3122 * Interpret string as a timezone abbreviation, if possible.
3123 *
3124 * Sets *ftype to an abbreviation type (TZ, DTZ, or DYNTZ), or UNKNOWN_FIELD if
3125 * string is not any known abbreviation. On success, set *offset and *tz to
3126 * represent the UTC offset (for TZ or DTZ) or underlying zone (for DYNTZ).
3127 * Note that full timezone names (such as America/New_York) are not handled
3128 * here, mostly for historical reasons.
3129 *
3130 * The function result is 0 or a DTERR code; in the latter case, *extra
3131 * is filled as needed. Note that unknown-abbreviation is not considered
3132 * an error case. Also note that many callers assume that the DTERR code
3133 * is one that DateTimeParseError does not require "str" or "datatype"
3134 * strings for.
3135 *
3136 * Given string must be lowercased already.
3137 *
3138 * Implement a cache lookup since it is likely that dates
3139 * will be related in format.
3140 */
3141int
3142DecodeTimezoneAbbrev(int field, const char *lowtoken,
3143 int *ftype, int *offset, pg_tz **tz,
3144 DateTimeErrorExtra *extra)
3145{
3146 TzAbbrevCache *tzc = &tzabbrevcache[field];
3147 bool isfixed;
3148 int isdst;
3149 const datetkn *tp;
3150
3151 /*
3152 * Do we have a cached result? Use strncmp so that we match truncated
3153 * names, although we shouldn't really see that happen with normal
3154 * abbreviations.
3155 */
3156 if (strncmp(lowtoken, tzc->abbrev, TOKMAXLEN) == 0)
3157 {
3158 *ftype = tzc->ftype;
3159 *offset = tzc->offset;
3160 *tz = tzc->tz;
3161 return 0;
3162 }
3163
3164 /*
3165 * See if the current session_timezone recognizes it. Checking this
3166 * before zoneabbrevtbl allows us to correctly handle abbreviations whose
3167 * meaning varies across zones, such as "LMT".
3168 */
3169 if (session_timezone &&
3170 TimeZoneAbbrevIsKnown(lowtoken, session_timezone,
3171 &isfixed, offset, &isdst))
3172 {
3173 *ftype = (isfixed ? (isdst ? DTZ : TZ) : DYNTZ);
3174 *tz = (isfixed ? NULL : session_timezone);
3175 /* flip sign to agree with the convention used in zoneabbrevtbl */
3176 *offset = -(*offset);
3177 /* cache result; use strlcpy to truncate name if necessary */
3178 strlcpy(tzc->abbrev, lowtoken, TOKMAXLEN + 1);
3179 tzc->ftype = *ftype;
3180 tzc->offset = *offset;
3181 tzc->tz = *tz;
3182 return 0;
3183 }
3184
3185 /* Nope, so look in zoneabbrevtbl */
3186 if (zoneabbrevtbl)
3187 tp = datebsearch(lowtoken, zoneabbrevtbl->abbrevs,
3188 zoneabbrevtbl->numabbrevs);
3189 else
3190 tp = NULL;
3191 if (tp == NULL)
3192 {
3193 *ftype = UNKNOWN_FIELD;
3194 *offset = 0;
3195 *tz = NULL;
3196 /* failure results are not cached */
3197 }
3198 else
3199 {
3200 *ftype = tp->type;
3201 if (tp->type == DYNTZ)
3202 {
3203 *offset = 0;
3204 *tz = FetchDynamicTimeZone(zoneabbrevtbl, tp, extra);
3205 if (*tz == NULL)
3206 return DTERR_BAD_ZONE_ABBREV;
3207 }
3208 else
3209 {
3210 *offset = tp->value;
3211 *tz = NULL;
3212 }
3213
3214 /* cache result; use strlcpy to truncate name if necessary */
3215 strlcpy(tzc->abbrev, lowtoken, TOKMAXLEN + 1);
3216 tzc->ftype = *ftype;
3217 tzc->offset = *offset;
3218 tzc->tz = *tz;
3219 }
3220
3221 return 0;
3222}
3223
3224/*
3225 * Reset tzabbrevcache after a change in session_timezone.
3226 */
3227void
3228ClearTimeZoneAbbrevCache(void)
3229{
3230 memset(tzabbrevcache, 0, sizeof(tzabbrevcache));
3231}
3232
3233
3234/* DecodeSpecial()
3235 * Decode text string using lookup table.
3236 *
3237 * Recognizes the keywords listed in datetktbl.
3238 * Note: at one time this would also recognize timezone abbreviations,
3239 * but no more; use DecodeTimezoneAbbrev for that.
3240 *
3241 * Given string must be lowercased already.
3242 *
3243 * Implement a cache lookup since it is likely that dates
3244 * will be related in format.
3245 */
3246int
3247DecodeSpecial(int field, const char *lowtoken, int *val)
3248{
3249 int type;
3250 const datetkn *tp;
3251
3252 tp = datecache[field];
3253 /* use strncmp so that we match truncated tokens */
3254 if (tp == NULL || strncmp(lowtoken, tp->token, TOKMAXLEN) != 0)
3255 {
3256 tp = datebsearch(lowtoken, datetktbl, szdatetktbl);
3257 }
3258 if (tp == NULL)
3259 {
3260 type = UNKNOWN_FIELD;
3261 *val = 0;
3262 }
3263 else
3264 {
3265 datecache[field] = tp;
3266 type = tp->type;
3267 *val = tp->value;
3268 }
3269
3270 return type;
3271}
3272
3273
3274/* DecodeTimezoneName()
3275 * Interpret string as a timezone abbreviation or name.
3276 * Throw error if the name is not recognized.
3277 *
3278 * The return value indicates what kind of zone identifier it is:
3279 * TZNAME_FIXED_OFFSET: fixed offset from UTC
3280 * TZNAME_DYNTZ: dynamic timezone abbreviation
3281 * TZNAME_ZONE: full tzdb zone name
3282 *
3283 * For TZNAME_FIXED_OFFSET, *offset receives the UTC offset (in seconds,
3284 * with ISO sign convention: positive is east of Greenwich).
3285 * For the other two cases, *tz receives the timezone struct representing
3286 * the zone name or the abbreviation's underlying zone.
3287 */
3288int
3289DecodeTimezoneName(const char *tzname, int *offset, pg_tz **tz)
3290{
3291 char *lowzone;
3292 int dterr,
3293 type;
3294 DateTimeErrorExtra extra;
3295
3296 /*
3297 * First we look in the timezone abbreviation table (to handle cases like
3298 * "EST"), and if that fails, we look in the timezone database (to handle
3299 * cases like "America/New_York"). This matches the order in which
3300 * timestamp input checks the cases; it's important because the timezone
3301 * database unwisely uses a few zone names that are identical to offset
3302 * abbreviations.
3303 */
3304
3305 /* DecodeTimezoneAbbrev requires lowercase input */
3306 lowzone = downcase_truncate_identifier(tzname,
3307 strlen(tzname),
3308 false);
3309
3310 dterr = DecodeTimezoneAbbrev(0, lowzone, &type, offset, tz, &extra);
3311 if (dterr)
3312 DateTimeParseError(dterr, &extra, NULL, NULL, NULL);
3313
3314 if (type == TZ || type == DTZ)
3315 {
3316 /* fixed-offset abbreviation, return the offset */
3317 return TZNAME_FIXED_OFFSET;
3318 }
3319 else if (type == DYNTZ)
3320 {
3321 /* dynamic-offset abbreviation, return its referenced timezone */
3322 return TZNAME_DYNTZ;
3323 }
3324 else
3325 {
3326 /* try it as a full zone name */
3327 *tz = pg_tzset(tzname);
3328 if (*tz == NULL)
3329 ereport(ERROR,
3330 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
3331 errmsg("time zone \"%s\" not recognized", tzname)));
3332 return TZNAME_ZONE;
3333 }
3334}
3335
3336/* DecodeTimezoneNameToTz()
3337 * Interpret string as a timezone abbreviation or name.
3338 * Throw error if the name is not recognized.
3339 *
3340 * This is a simple wrapper for DecodeTimezoneName that produces a pg_tz *
3341 * result in all cases.
3342 */
3343pg_tz *
3344DecodeTimezoneNameToTz(const char *tzname)
3345{
3346 pg_tz *result;
3347 int offset;
3348
3349 if (DecodeTimezoneName(tzname, &offset, &result) == TZNAME_FIXED_OFFSET)
3350 {
3351 /* fixed-offset abbreviation, get a pg_tz descriptor for that */
3352 result = pg_tzset_offset(-offset); /* flip to POSIX sign convention */
3353 }
3354 return result;
3355}
3356
3357/* DecodeTimezoneAbbrevPrefix()
3358 * Interpret prefix of string as a timezone abbreviation, if possible.
3359 *
3360 * This has roughly the same functionality as DecodeTimezoneAbbrev(),
3361 * but the API is adapted to the needs of formatting.c. Notably,
3362 * we will match the longest possible prefix of the given string
3363 * rather than insisting on a complete match, and downcasing is applied
3364 * here rather than in the caller.
3365 *
3366 * Returns the length of the timezone abbreviation, or -1 if not recognized.
3367 * On success, sets *offset to the GMT offset for the abbreviation if it
3368 * is a fixed-offset abbreviation, or sets *tz to the pg_tz struct for
3369 * a dynamic abbreviation.
3370 */
3371int
3372DecodeTimezoneAbbrevPrefix(const char *str, int *offset, pg_tz **tz)
3373{
3374 char lowtoken[TOKMAXLEN + 1];
3375 int len;
3376
3377 *offset = 0; /* avoid uninitialized vars on failure */
3378 *tz = NULL;
3379
3380 /* Downcase as much of the string as we could need */
3381 for (len = 0; len < TOKMAXLEN; len++)
3382 {
3383 if (*str == '\0' || !isalpha((unsigned char) *str))
3384 break;
3385 lowtoken[len] = pg_tolower((unsigned char) *str++);
3386 }
3387 lowtoken[len] = '\0';
3388
3389 /*
3390 * We could avoid doing repeated binary searches if we cared to duplicate
3391 * datebsearch here, but it's not clear that such an optimization would be
3392 * worth the trouble. In common cases there's probably not anything after
3393 * the zone abbrev anyway. So just search with successively truncated
3394 * strings.
3395 */
3396 while (len > 0)
3397 {
3398 bool isfixed;
3399 int isdst;
3400 const datetkn *tp;
3401
3402 /* See if the current session_timezone recognizes it. */
3403 if (session_timezone &&
3404 TimeZoneAbbrevIsKnown(lowtoken, session_timezone,
3405 &isfixed, offset, &isdst))
3406 {
3407 if (isfixed)
3408 {
3409 /* flip sign to agree with the convention in zoneabbrevtbl */
3410 *offset = -(*offset);
3411 }
3412 else
3413 {
3414 /* Caller must resolve the abbrev's current meaning */
3415 *tz = session_timezone;
3416 }
3417 return len;
3418 }
3419
3420 /* Known in zoneabbrevtbl? */
3421 if (zoneabbrevtbl)
3422 tp = datebsearch(lowtoken, zoneabbrevtbl->abbrevs,
3423 zoneabbrevtbl->numabbrevs);
3424 else
3425 tp = NULL;
3426 if (tp != NULL)
3427 {
3428 if (tp->type == DYNTZ)
3429 {
3430 DateTimeErrorExtra extra;
3431 pg_tz *tzp = FetchDynamicTimeZone(zoneabbrevtbl, tp,
3432 &extra);
3433
3434 if (tzp != NULL)
3435 {
3436 /* Caller must resolve the abbrev's current meaning */
3437 *tz = tzp;
3438 return len;
3439 }
3440 }
3441 else
3442 {
3443 /* Fixed-offset zone abbrev, so it's easy */
3444 *offset = tp->value;
3445 return len;
3446 }
3447 }
3448
3449 /* Nope, try the next shorter string. */
3450 lowtoken[--len] = '\0';
3451 }
3452
3453 /* Did not find a match */
3454 return -1;
3455}
3456
3457
3458/* ClearPgItmIn
3459 *
3460 * Zero out a pg_itm_in
3461 */
3462static inline void
3463ClearPgItmIn(struct pg_itm_in *itm_in)
3464{
3465 itm_in->tm_usec = 0;
3466 itm_in->tm_mday = 0;
3467 itm_in->tm_mon = 0;
3468 itm_in->tm_year = 0;
3469}
3470
3471
3472/* DecodeInterval()
3473 * Interpret previously parsed fields for general time interval.
3474 * Returns 0 if successful, DTERR code if bogus input detected.
3475 * dtype and itm_in are output parameters.
3476 *
3477 * Allow "date" field DTK_DATE since this could be just
3478 * an unsigned floating point number. - thomas 1997-11-16
3479 *
3480 * Allow ISO-style time span, with implicit units on number of days
3481 * preceding an hh:mm:ss field. - thomas 1998-04-30
3482 *
3483 * itm_in remains undefined for infinite interval values for which dtype alone
3484 * suffices.
3485 */
3486int
3487DecodeInterval(char **field, int *ftype, int nf, int range,
3488 int *dtype, struct pg_itm_in *itm_in)
3489{
3490 bool force_negative = false;
3491 bool is_before = false;
3492 bool parsing_unit_val = false;
3493 char *cp;
3494 int fmask = 0,
3495 tmask,
3496 type,
3497 uval;
3498 int i;
3499 int dterr;
3500 int64 val;
3501 double fval;
3502
3503 *dtype = DTK_DELTA;
3504 type = IGNORE_DTF;
3505 ClearPgItmIn(itm_in);
3506
3507 /*----------
3508 * The SQL standard defines the interval literal
3509 * '-1 1:00:00'
3510 * to mean "negative 1 days and negative 1 hours", while Postgres
3511 * traditionally treats this as meaning "negative 1 days and positive
3512 * 1 hours". In SQL_STANDARD intervalstyle, we apply the leading sign
3513 * to all fields if there are no other explicit signs.
3514 *
3515 * We leave the signs alone if there are additional explicit signs.
3516 * This protects us against misinterpreting postgres-style dump output,
3517 * since the postgres-style output code has always put an explicit sign on
3518 * all fields following a negative field. But note that SQL-spec output
3519 * is ambiguous and can be misinterpreted on load! (So it's best practice
3520 * to dump in postgres style, not SQL style.)
3521 *----------
3522 */
3523 if (IntervalStyle == INTSTYLE_SQL_STANDARD && nf > 0 && *field[0] == '-')
3524 {
3525 force_negative = true;
3526 /* Check for additional explicit signs */
3527 for (i = 1; i < nf; i++)
3528 {
3529 if (*field[i] == '-' || *field[i] == '+')
3530 {
3531 force_negative = false;
3532 break;
3533 }
3534 }
3535 }
3536
3537 /* read through list backwards to pick up units before values */
3538 for (i = nf - 1; i >= 0; i--)
3539 {
3540 switch (ftype[i])
3541 {
3542 case DTK_TIME:
3543 dterr = DecodeTimeForInterval(field[i], fmask, range,
3544 &tmask, itm_in);
3545 if (dterr)
3546 return dterr;
3547 if (force_negative &&
3548 itm_in->tm_usec > 0)
3549 itm_in->tm_usec = -itm_in->tm_usec;
3550 type = DTK_DAY;
3551 parsing_unit_val = false;
3552 break;
3553
3554 case DTK_TZ:
3555
3556 /*
3557 * Timezone means a token with a leading sign character and at
3558 * least one digit; there could be ':', '.', '-' embedded in
3559 * it as well.
3560 */
3561 Assert(*field[i] == '-' || *field[i] == '+');
3562
3563 /*
3564 * Check for signed hh:mm or hh:mm:ss. If so, process exactly
3565 * like DTK_TIME case above, plus handling the sign.
3566 */
3567 if (strchr(field[i] + 1, ':') != NULL &&
3568 DecodeTimeForInterval(field[i] + 1, fmask, range,
3569 &tmask, itm_in) == 0)
3570 {
3571 if (*field[i] == '-')
3572 {
3573 /* flip the sign on time field */
3574 if (itm_in->tm_usec == PG_INT64_MIN)
3575 return DTERR_FIELD_OVERFLOW;
3576 itm_in->tm_usec = -itm_in->tm_usec;
3577 }
3578
3579 if (force_negative &&
3580 itm_in->tm_usec > 0)
3581 itm_in->tm_usec = -itm_in->tm_usec;
3582
3583 /*
3584 * Set the next type to be a day, if units are not
3585 * specified. This handles the case of '1 +02:03' since we
3586 * are reading right to left.
3587 */
3588 type = DTK_DAY;
3589 parsing_unit_val = false;
3590 break;
3591 }
3592
3593 /*
3594 * Otherwise, fall through to DTK_NUMBER case, which can
3595 * handle signed float numbers and signed year-month values.
3596 */
3597
3598 pg_fallthrough;
3599
3600 case DTK_DATE:
3601 case DTK_NUMBER:
3602 if (type == IGNORE_DTF)
3603 {
3604 /* use typmod to decide what rightmost field is */
3605 switch (range)
3606 {
3607 case INTERVAL_MASK(YEAR):
3608 type = DTK_YEAR;
3609 break;
3610 case INTERVAL_MASK(MONTH):
3611 case INTERVAL_MASK(YEAR) | INTERVAL_MASK(MONTH):
3612 type = DTK_MONTH;
3613 break;
3614 case INTERVAL_MASK(DAY):
3615 type = DTK_DAY;
3616 break;
3617 case INTERVAL_MASK(HOUR):
3618 case INTERVAL_MASK(DAY) | INTERVAL_MASK(HOUR):
3619 type = DTK_HOUR;
3620 break;
3621 case INTERVAL_MASK(MINUTE):
3622 case INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE):
3623 case INTERVAL_MASK(DAY) | INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE):
3624 type = DTK_MINUTE;
3625 break;
3626 case INTERVAL_MASK(SECOND):
3627 case INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND):
3628 case INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND):
3629 case INTERVAL_MASK(DAY) | INTERVAL_MASK(HOUR) | INTERVAL_MASK(MINUTE) | INTERVAL_MASK(SECOND):
3630 type = DTK_SECOND;
3631 break;
3632 default:
3633 type = DTK_SECOND;
3634 break;
3635 }
3636 }
3637
3638 errno = 0;
3639 val = strtoi64(field[i], &cp, 10);
3640 if (errno == ERANGE)
3641 return DTERR_FIELD_OVERFLOW;
3642
3643 if (*cp == '-')
3644 {
3645 /* SQL "years-months" syntax */
3646 int val2;
3647
3648 val2 = strtoint(cp + 1, &cp, 10);
3649 if (errno == ERANGE || val2 < 0 || val2 >= MONTHS_PER_YEAR)
3650 return DTERR_FIELD_OVERFLOW;
3651 if (*cp != '\0')
3652 return DTERR_BAD_FORMAT;
3653 type = DTK_MONTH;
3654 if (*field[i] == '-')
3655 val2 = -val2;
3656 if (pg_mul_s64_overflow(val, MONTHS_PER_YEAR, &val))
3657 return DTERR_FIELD_OVERFLOW;
3658 if (pg_add_s64_overflow(val, val2, &val))
3659 return DTERR_FIELD_OVERFLOW;
3660 fval = 0;
3661 }
3662 else if (*cp == '.')
3663 {
3664 dterr = ParseFraction(cp, &fval);
3665 if (dterr)
3666 return dterr;
3667 if (*field[i] == '-')
3668 fval = -fval;
3669 }
3670 else if (*cp == '\0')
3671 fval = 0;
3672 else
3673 return DTERR_BAD_FORMAT;
3674
3675 tmask = 0; /* DTK_M(type); */
3676
3677 if (force_negative)
3678 {
3679 /* val and fval should be of same sign, but test anyway */
3680 if (val > 0)
3681 val = -val;
3682 if (fval > 0)
3683 fval = -fval;
3684 }
3685
3686 switch (type)
3687 {
3688 case DTK_MICROSEC:
3689 if (!AdjustMicroseconds(val, fval, 1, itm_in))
3690 return DTERR_FIELD_OVERFLOW;
3691 tmask = DTK_M(MICROSECOND);
3692 break;
3693
3694 case DTK_MILLISEC:
3695 if (!AdjustMicroseconds(val, fval, 1000, itm_in))
3696 return DTERR_FIELD_OVERFLOW;
3697 tmask = DTK_M(MILLISECOND);
3698 break;
3699
3700 case DTK_SECOND:
3701 if (!AdjustMicroseconds(val, fval, USECS_PER_SEC, itm_in))
3702 return DTERR_FIELD_OVERFLOW;
3703
3704 /*
3705 * If any subseconds were specified, consider this
3706 * microsecond and millisecond input as well.
3707 */
3708 if (fval == 0)
3709 tmask = DTK_M(SECOND);
3710 else
3711 tmask = DTK_ALL_SECS_M;
3712 break;
3713
3714 case DTK_MINUTE:
3715 if (!AdjustMicroseconds(val, fval, USECS_PER_MINUTE, itm_in))
3716 return DTERR_FIELD_OVERFLOW;
3717 tmask = DTK_M(MINUTE);
3718 break;
3719
3720 case DTK_HOUR:
3721 if (!AdjustMicroseconds(val, fval, USECS_PER_HOUR, itm_in))
3722 return DTERR_FIELD_OVERFLOW;
3723 tmask = DTK_M(HOUR);
3724 type = DTK_DAY; /* set for next field */
3725 break;
3726
3727 case DTK_DAY:
3728 if (!AdjustDays(val, 1, itm_in) ||
3729 !AdjustFractMicroseconds(fval, USECS_PER_DAY, itm_in))
3730 return DTERR_FIELD_OVERFLOW;
3731 tmask = DTK_M(DAY);
3732 break;
3733
3734 case DTK_WEEK:
3735 if (!AdjustDays(val, 7, itm_in) ||
3736 !AdjustFractDays(fval, 7, itm_in))
3737 return DTERR_FIELD_OVERFLOW;
3738 tmask = DTK_M(WEEK);
3739 break;
3740
3741 case DTK_MONTH:
3742 if (!AdjustMonths(val, itm_in) ||
3743 !AdjustFractDays(fval, DAYS_PER_MONTH, itm_in))
3744 return DTERR_FIELD_OVERFLOW;
3745 tmask = DTK_M(MONTH);
3746 break;
3747
3748 case DTK_YEAR:
3749 if (!AdjustYears(val, 1, itm_in) ||
3750 !AdjustFractYears(fval, 1, itm_in))
3751 return DTERR_FIELD_OVERFLOW;
3752 tmask = DTK_M(YEAR);
3753 break;
3754
3755 case DTK_DECADE:
3756 if (!AdjustYears(val, 10, itm_in) ||
3757 !AdjustFractYears(fval, 10, itm_in))
3758 return DTERR_FIELD_OVERFLOW;
3759 tmask = DTK_M(DECADE);
3760 break;
3761
3762 case DTK_CENTURY:
3763 if (!AdjustYears(val, 100, itm_in) ||
3764 !AdjustFractYears(fval, 100, itm_in))
3765 return DTERR_FIELD_OVERFLOW;
3766 tmask = DTK_M(CENTURY);
3767 break;
3768
3769 case DTK_MILLENNIUM:
3770 if (!AdjustYears(val, 1000, itm_in) ||
3771 !AdjustFractYears(fval, 1000, itm_in))
3772 return DTERR_FIELD_OVERFLOW;
3773 tmask = DTK_M(MILLENNIUM);
3774 break;
3775
3776 default:
3777 return DTERR_BAD_FORMAT;
3778 }
3779 parsing_unit_val = false;
3780 break;
3781
3782 case DTK_STRING:
3783 case DTK_SPECIAL:
3784 /* reject consecutive unhandled units */
3785 if (parsing_unit_val)
3786 return DTERR_BAD_FORMAT;
3787 type = DecodeUnits(i, field[i], &uval);
3788 if (type == UNKNOWN_FIELD)
3789 type = DecodeSpecial(i, field[i], &uval);
3790 if (type == IGNORE_DTF)
3791 continue;
3792
3793 tmask = 0; /* DTK_M(type); */
3794 switch (type)
3795 {
3796 case UNITS:
3797 type = uval;
3798 parsing_unit_val = true;
3799 break;
3800
3801 case AGO:
3802
3803 /*
3804 * "ago" is only allowed to appear at the end of the
3805 * interval.
3806 */
3807 if (i != nf - 1)
3808 return DTERR_BAD_FORMAT;
3809 is_before = true;
3810 type = uval;
3811 break;
3812
3813 case RESERV:
3814 tmask = (DTK_DATE_M | DTK_TIME_M);
3815
3816 /*
3817 * Only reserved words corresponding to infinite
3818 * intervals are accepted.
3819 */
3820 if (uval != DTK_LATE && uval != DTK_EARLY)
3821 return DTERR_BAD_FORMAT;
3822
3823 /*
3824 * Infinity cannot be followed by anything else. We
3825 * could allow "ago" to reverse the sign of infinity
3826 * but using signed infinity is more intuitive.
3827 */
3828 if (i != nf - 1)
3829 return DTERR_BAD_FORMAT;
3830
3831 *dtype = uval;
3832 break;
3833
3834 default:
3835 return DTERR_BAD_FORMAT;
3836 }
3837 break;
3838
3839 default:
3840 return DTERR_BAD_FORMAT;
3841 }
3842
3843 if (tmask & fmask)
3844 return DTERR_BAD_FORMAT;
3845 fmask |= tmask;
3846 }
3847
3848 /* ensure that at least one time field has been found */
3849 if (fmask == 0)
3850 return DTERR_BAD_FORMAT;
3851
3852 /* reject if unit appeared and was never handled */
3853 if (parsing_unit_val)
3854 return DTERR_BAD_FORMAT;
3855
3856 /* finally, AGO negates everything */
3857 if (is_before)
3858 {
3859 if (itm_in->tm_usec == PG_INT64_MIN ||
3860 itm_in->tm_mday == INT_MIN ||
3861 itm_in->tm_mon == INT_MIN ||
3862 itm_in->tm_year == INT_MIN)
3863 return DTERR_FIELD_OVERFLOW;
3864
3865 itm_in->tm_usec = -itm_in->tm_usec;
3866 itm_in->tm_mday = -itm_in->tm_mday;
3867 itm_in->tm_mon = -itm_in->tm_mon;
3868 itm_in->tm_year = -itm_in->tm_year;
3869 }
3870
3871 return 0;
3872}
3873
3874
3875/*
3876 * Helper functions to avoid duplicated code in DecodeISO8601Interval.
3877 *
3878 * Parse a decimal value and break it into integer and fractional parts.
3879 * Set *endptr to end+1 of the parsed substring.
3880 * Returns 0 or DTERR code.
3881 */
3882static int
3883ParseISO8601Number(char *str, char **endptr, int64 *ipart, double *fpart)
3884{
3885 double val;
3886
3887 /*
3888 * Historically this has accepted anything that strtod() would take,
3889 * notably including "e" notation, so continue doing that. This is
3890 * slightly annoying because the precision of double is less than that of
3891 * int64, so we would lose accuracy for inputs larger than 2^53 or so.
3892 * However, historically we rejected inputs outside the int32 range,
3893 * making that concern moot. What we do now is reject abs(val) above
3894 * 1.0e15 (a round number a bit less than 2^50), so that any accepted
3895 * value will have an exact integer part, and thereby a fraction part with
3896 * abs(*fpart) less than 1. In the absence of field complaints it doesn't
3897 * seem worth working harder.
3898 */
3899 if (!(isdigit((unsigned char) *str) || *str == '-' || *str == '.'))
3900 return DTERR_BAD_FORMAT;
3901 errno = 0;
3902 val = strtod(str, endptr);
3903 /* did we not see anything that looks like a double? */
3904 if (*endptr == str || errno != 0)
3905 return DTERR_BAD_FORMAT;
3906 /* watch out for overflow, including infinities; reject NaN too */
3907 if (isnan(val) || val < -1.0e15 || val > 1.0e15)
3908 return DTERR_FIELD_OVERFLOW;
3909 /* be very sure we truncate towards zero (cf dtrunc()) */
3910 if (val >= 0)
3911 *ipart = (int64) floor(val);
3912 else
3913 *ipart = (int64) -floor(-val);
3914 *fpart = val - *ipart;
3915 /* Callers expect this to hold */
3916 Assert(*fpart > -1.0 && *fpart < 1.0);
3917 return 0;
3918}
3919
3920/*
3921 * Determine number of integral digits in a valid ISO 8601 number field
3922 * (we should ignore sign and any fraction part)
3923 */
3924static int
3925ISO8601IntegerWidth(char *fieldstart)
3926{
3927 /* We might have had a leading '-' */
3928 if (*fieldstart == '-')
3929 fieldstart++;
3930 return strspn(fieldstart, "0123456789");
3931}
3932
3933
3934/* DecodeISO8601Interval()
3935 * Decode an ISO 8601 time interval of the "format with designators"
3936 * (section 4.4.3.2) or "alternative format" (section 4.4.3.3)
3937 * Examples: P1D for 1 day
3938 * PT1H for 1 hour
3939 * P2Y6M7DT1H30M for 2 years, 6 months, 7 days 1 hour 30 min
3940 * P0002-06-07T01:30:00 the same value in alternative format
3941 *
3942 * Returns 0 if successful, DTERR code if bogus input detected.
3943 * Note: error code should be DTERR_BAD_FORMAT if input doesn't look like
3944 * ISO8601, otherwise this could cause unexpected error messages.
3945 * dtype and itm_in are output parameters.
3946 *
3947 * A couple exceptions from the spec:
3948 * - a week field ('W') may coexist with other units
3949 * - allows decimals in fields other than the least significant unit.
3950 */
3951int
3952DecodeISO8601Interval(char *str,
3953 int *dtype, struct pg_itm_in *itm_in)
3954{
3955 bool datepart = true;
3956 bool havefield = false;
3957
3958 *dtype = DTK_DELTA;
3959 ClearPgItmIn(itm_in);
3960
3961 if (strlen(str) < 2 || str[0] != 'P')
3962 return DTERR_BAD_FORMAT;
3963
3964 str++;
3965 while (*str)
3966 {
3967 char *fieldstart;
3968 int64 val;
3969 double fval;
3970 char unit;
3971 int dterr;
3972
3973 if (*str == 'T') /* T indicates the beginning of the time part */
3974 {
3975 datepart = false;
3976 havefield = false;
3977 str++;
3978 continue;
3979 }
3980
3981 fieldstart = str;
3982 dterr = ParseISO8601Number(str, &str, &val, &fval);
3983 if (dterr)
3984 return dterr;
3985
3986 /*
3987 * Note: we could step off the end of the string here. Code below
3988 * *must* exit the loop if unit == '\0'.
3989 */
3990 unit = *str++;
3991
3992 if (datepart)
3993 {
3994 switch (unit) /* before T: Y M W D */
3995 {
3996 case 'Y':
3997 if (!AdjustYears(val, 1, itm_in) ||
3998 !AdjustFractYears(fval, 1, itm_in))
3999 return DTERR_FIELD_OVERFLOW;
4000 break;
4001 case 'M':
4002 if (!AdjustMonths(val, itm_in) ||
4003 !AdjustFractDays(fval, DAYS_PER_MONTH, itm_in))
4004 return DTERR_FIELD_OVERFLOW;
4005 break;
4006 case 'W':
4007 if (!AdjustDays(val, 7, itm_in) ||
4008 !AdjustFractDays(fval, 7, itm_in))
4009 return DTERR_FIELD_OVERFLOW;
4010 break;
4011 case 'D':
4012 if (!AdjustDays(val, 1, itm_in) ||
4013 !AdjustFractMicroseconds(fval, USECS_PER_DAY, itm_in))
4014 return DTERR_FIELD_OVERFLOW;
4015 break;
4016 case 'T': /* ISO 8601 4.4.3.3 Alternative Format / Basic */
4017 case '\0':
4018 if (ISO8601IntegerWidth(fieldstart) == 8 && !havefield)
4019 {
4020 if (!AdjustYears(val / 10000, 1, itm_in) ||
4021 !AdjustMonths((val / 100) % 100, itm_in) ||
4022 !AdjustDays(val % 100, 1, itm_in) ||
4023 !AdjustFractMicroseconds(fval, USECS_PER_DAY, itm_in))
4024 return DTERR_FIELD_OVERFLOW;
4025 if (unit == '\0')
4026 return 0;
4027 datepart = false;
4028 havefield = false;
4029 continue;
4030 }
4031 /* Else fall through to extended alternative format */
4032 pg_fallthrough;
4033 case '-': /* ISO 8601 4.4.3.3 Alternative Format,
4034 * Extended */
4035 if (havefield)
4036 return DTERR_BAD_FORMAT;
4037
4038 if (!AdjustYears(val, 1, itm_in) ||
4039 !AdjustFractYears(fval, 1, itm_in))
4040 return DTERR_FIELD_OVERFLOW;
4041 if (unit == '\0')
4042 return 0;
4043 if (unit == 'T')
4044 {
4045 datepart = false;
4046 havefield = false;
4047 continue;
4048 }
4049
4050 dterr = ParseISO8601Number(str, &str, &val, &fval);
4051 if (dterr)
4052 return dterr;
4053 if (!AdjustMonths(val, itm_in) ||
4054 !AdjustFractDays(fval, DAYS_PER_MONTH, itm_in))
4055 return DTERR_FIELD_OVERFLOW;
4056 if (*str == '\0')
4057 return 0;
4058 if (*str == 'T')
4059 {
4060 datepart = false;
4061 havefield = false;
4062 continue;
4063 }
4064 if (*str != '-')
4065 return DTERR_BAD_FORMAT;
4066 str++;
4067
4068 dterr = ParseISO8601Number(str, &str, &val, &fval);
4069 if (dterr)
4070 return dterr;
4071 if (!AdjustDays(val, 1, itm_in) ||
4072 !AdjustFractMicroseconds(fval, USECS_PER_DAY, itm_in))
4073 return DTERR_FIELD_OVERFLOW;
4074 if (*str == '\0')
4075 return 0;
4076 if (*str == 'T')
4077 {
4078 datepart = false;
4079 havefield = false;
4080 continue;
4081 }
4082 return DTERR_BAD_FORMAT;
4083 default:
4084 /* not a valid date unit suffix */
4085 return DTERR_BAD_FORMAT;
4086 }
4087 }
4088 else
4089 {
4090 switch (unit) /* after T: H M S */
4091 {
4092 case 'H':
4093 if (!AdjustMicroseconds(val, fval, USECS_PER_HOUR, itm_in))
4094 return DTERR_FIELD_OVERFLOW;
4095 break;
4096 case 'M':
4097 if (!AdjustMicroseconds(val, fval, USECS_PER_MINUTE, itm_in))
4098 return DTERR_FIELD_OVERFLOW;
4099 break;
4100 case 'S':
4101 if (!AdjustMicroseconds(val, fval, USECS_PER_SEC, itm_in))
4102 return DTERR_FIELD_OVERFLOW;
4103 break;
4104 case '\0': /* ISO 8601 4.4.3.3 Alternative Format */
4105 if (ISO8601IntegerWidth(fieldstart) == 6 && !havefield)
4106 {
4107 if (!AdjustMicroseconds(val / 10000, 0, USECS_PER_HOUR, itm_in) ||
4108 !AdjustMicroseconds((val / 100) % 100, 0, USECS_PER_MINUTE, itm_in) ||
4109 !AdjustMicroseconds(val % 100, 0, USECS_PER_SEC, itm_in) ||
4110 !AdjustFractMicroseconds(fval, 1, itm_in))
4111 return DTERR_FIELD_OVERFLOW;
4112 return 0;
4113 }
4114 /* Else fall through to extended alternative format */
4115 pg_fallthrough;
4116 case ':': /* ISO 8601 4.4.3.3 Alternative Format,
4117 * Extended */
4118 if (havefield)
4119 return DTERR_BAD_FORMAT;
4120
4121 if (!AdjustMicroseconds(val, fval, USECS_PER_HOUR, itm_in))
4122 return DTERR_FIELD_OVERFLOW;
4123 if (unit == '\0')
4124 return 0;
4125
4126 dterr = ParseISO8601Number(str, &str, &val, &fval);
4127 if (dterr)
4128 return dterr;
4129 if (!AdjustMicroseconds(val, fval, USECS_PER_MINUTE, itm_in))
4130 return DTERR_FIELD_OVERFLOW;
4131 if (*str == '\0')
4132 return 0;
4133 if (*str != ':')
4134 return DTERR_BAD_FORMAT;
4135 str++;
4136
4137 dterr = ParseISO8601Number(str, &str, &val, &fval);
4138 if (dterr)
4139 return dterr;
4140 if (!AdjustMicroseconds(val, fval, USECS_PER_SEC, itm_in))
4141 return DTERR_FIELD_OVERFLOW;
4142 if (*str == '\0')
4143 return 0;
4144 return DTERR_BAD_FORMAT;
4145
4146 default:
4147 /* not a valid time unit suffix */
4148 return DTERR_BAD_FORMAT;
4149 }
4150 }
4151
4152 havefield = true;
4153 }
4154
4155 return 0;
4156}
4157
4158
4159/* DecodeUnits()
4160 * Decode text string using lookup table.
4161 *
4162 * This routine recognizes keywords associated with time interval units.
4163 *
4164 * Given string must be lowercased already.
4165 *
4166 * Implement a cache lookup since it is likely that dates
4167 * will be related in format.
4168 */
4169int
4170DecodeUnits(int field, const char *lowtoken, int *val)
4171{
4172 int type;
4173 const datetkn *tp;
4174
4175 tp = deltacache[field];
4176 /* use strncmp so that we match truncated tokens */
4177 if (tp == NULL || strncmp(lowtoken, tp->token, TOKMAXLEN) != 0)
4178 {
4179 tp = datebsearch(lowtoken, deltatktbl, szdeltatktbl);
4180 }
4181 if (tp == NULL)
4182 {
4183 type = UNKNOWN_FIELD;
4184 *val = 0;
4185 }
4186 else
4187 {
4188 deltacache[field] = tp;
4189 type = tp->type;
4190 *val = tp->value;
4191 }
4192
4193 return type;
4194} /* DecodeUnits() */
4195
4196/*
4197 * Report an error detected by one of the datetime input processing routines.
4198 *
4199 * dterr is the error code, and *extra contains any auxiliary info we need
4200 * for the error report. extra can be NULL if not needed for the particular
4201 * dterr value.
4202 *
4203 * str is the original input string, and datatype is the name of the datatype
4204 * we were trying to accept. (For some DTERR codes, these are not used and
4205 * can be NULL.)
4206 *
4207 * If escontext points to an ErrorSaveContext node, that is filled instead
4208 * of throwing an error.
4209 *
4210 * Note: it might seem useless to distinguish DTERR_INTERVAL_OVERFLOW and
4211 * DTERR_TZDISP_OVERFLOW from DTERR_FIELD_OVERFLOW, but SQL99 mandates three
4212 * separate SQLSTATE codes, so ...
4213 */
4214void
4215DateTimeParseError(int dterr, DateTimeErrorExtra *extra,
4216 const char *str, const char *datatype,
4217 Node *escontext)
4218{
4219 switch (dterr)
4220 {
4221 case DTERR_FIELD_OVERFLOW:
4222 errsave(escontext,
4223 (errcode(ERRCODE_DATETIME_FIELD_OVERFLOW),
4224 errmsg("date/time field value out of range: \"%s\"",
4225 str)));
4226 break;
4227 case DTERR_MD_FIELD_OVERFLOW:
4228 /* <nanny>same as above, but add hint about DateStyle</nanny> */
4229 errsave(escontext,
4230 (errcode(ERRCODE_DATETIME_FIELD_OVERFLOW),
4231 errmsg("date/time field value out of range: \"%s\"",
4232 str),
4233 errhint("Perhaps you need a different \"DateStyle\" setting.")));
4234 break;
4235 case DTERR_INTERVAL_OVERFLOW:
4236 errsave(escontext,
4237 (errcode(ERRCODE_INTERVAL_FIELD_OVERFLOW),
4238 errmsg("interval field value out of range: \"%s\"",
4239 str)));
4240 break;
4241 case DTERR_TZDISP_OVERFLOW:
4242 errsave(escontext,
4243 (errcode(ERRCODE_INVALID_TIME_ZONE_DISPLACEMENT_VALUE),
4244 errmsg("time zone displacement out of range: \"%s\"",
4245 str)));
4246 break;
4247 case DTERR_BAD_TIMEZONE:
4248 errsave(escontext,
4249 (errcode(ERRCODE_INVALID_PARAMETER_VALUE),
4250 errmsg("time zone \"%s\" not recognized",
4251 extra->dtee_timezone)));
4252 break;
4253 case DTERR_BAD_ZONE_ABBREV:
4254 errsave(escontext,
4255 (errcode(ERRCODE_CONFIG_FILE_ERROR),
4256 errmsg("time zone \"%s\" not recognized",
4257 extra->dtee_timezone),
4258 errdetail("This time zone name appears in the configuration file for time zone abbreviation \"%s\".",
4259 extra->dtee_abbrev)));
4260 break;
4261 case DTERR_BAD_FORMAT:
4262 default:
4263 errsave(escontext,
4264 (errcode(ERRCODE_INVALID_DATETIME_FORMAT),
4265 errmsg("invalid input syntax for type %s: \"%s\"",
4266 datatype, str)));
4267 break;
4268 }
4269}
4270
4271/* datebsearch()
4272 * Binary search -- from Knuth (6.2.1) Algorithm B. Special case like this
4273 * is WAY faster than the generic bsearch().
4274 */
4275static const datetkn *
4276datebsearch(const char *key, const datetkn *base, int nel)
4277{
4278 if (nel > 0)
4279 {
4280 const datetkn *last = base + nel - 1,
4281 *position;
4282 int result;
4283
4284 while (last >= base)
4285 {
4286 position = base + ((last - base) >> 1);
4287 /* precheck the first character for a bit of extra speed */
4288 result = (int) key[0] - (int) position->token[0];
4289 if (result == 0)
4290 {
4291 /* use strncmp so that we match truncated tokens */
4292 result = strncmp(key, position->token, TOKMAXLEN);
4293 if (result == 0)
4294 return position;
4295 }
4296 if (result < 0)
4297 last = position - 1;
4298 else
4299 base = position + 1;
4300 }
4301 }
4302 return NULL;
4303}
4304
4305/* EncodeTimezone()
4306 * Copies representation of a numeric timezone offset to str.
4307 *
4308 * Returns a pointer to the new end of string. No NUL terminator is put
4309 * there; callers are responsible for NUL terminating str themselves.
4310 */
4311static char *
4312EncodeTimezone(char *str, int tz, int style)
4313{
4314 int hour,
4315 min,
4316 sec;
4317
4318 sec = abs(tz);
4319 min = sec / SECS_PER_MINUTE;
4320 sec -= min * SECS_PER_MINUTE;
4321 hour = min / MINS_PER_HOUR;
4322 min -= hour * MINS_PER_HOUR;
4323
4324 /* TZ is negated compared to sign we wish to display ... */
4325 *str++ = (tz <= 0 ? '+' : '-');
4326
4327 if (sec != 0)
4328 {
4329 str = pg_ultostr_zeropad(str, hour, 2);
4330 *str++ = ':';
4331 str = pg_ultostr_zeropad(str, min, 2);
4332 *str++ = ':';
4333 str = pg_ultostr_zeropad(str, sec, 2);
4334 }
4335 else if (min != 0 || style == USE_XSD_DATES)
4336 {
4337 str = pg_ultostr_zeropad(str, hour, 2);
4338 *str++ = ':';
4339 str = pg_ultostr_zeropad(str, min, 2);
4340 }
4341 else
4342 str = pg_ultostr_zeropad(str, hour, 2);
4343 return str;
4344}
4345
4346/* EncodeDateOnly()
4347 * Encode date as local time.
4348 */
4349void
4350EncodeDateOnly(struct pg_tm *tm, int style, char *str)
4351{
4352 Assert(tm->tm_mon >= 1 && tm->tm_mon <= MONTHS_PER_YEAR);
4353
4354 switch (style)
4355 {
4356 case USE_ISO_DATES:
4357 case USE_XSD_DATES:
4358 /* compatible with ISO date formats */
4359 str = pg_ultostr_zeropad(str,
4360 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4361 *str++ = '-';
4362 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4363 *str++ = '-';
4364 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4365 break;
4366
4367 case USE_SQL_DATES:
4368 /* compatible with Oracle/Ingres date formats */
4369 if (DateOrder == DATEORDER_DMY)
4370 {
4371 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4372 *str++ = '/';
4373 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4374 }
4375 else
4376 {
4377 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4378 *str++ = '/';
4379 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4380 }
4381 *str++ = '/';
4382 str = pg_ultostr_zeropad(str,
4383 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4384 break;
4385
4386 case USE_GERMAN_DATES:
4387 /* German-style date format */
4388 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4389 *str++ = '.';
4390 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4391 *str++ = '.';
4392 str = pg_ultostr_zeropad(str,
4393 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4394 break;
4395
4396 case USE_POSTGRES_DATES:
4397 default:
4398 /* traditional date-only style for Postgres */
4399 if (DateOrder == DATEORDER_DMY)
4400 {
4401 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4402 *str++ = '-';
4403 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4404 }
4405 else
4406 {
4407 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4408 *str++ = '-';
4409 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4410 }
4411 *str++ = '-';
4412 str = pg_ultostr_zeropad(str,
4413 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4414 break;
4415 }
4416
4417 if (tm->tm_year <= 0)
4418 {
4419 memcpy(str, " BC", 3); /* Don't copy NUL */
4420 str += 3;
4421 }
4422 *str = '\0';
4423}
4424
4425
4426/* EncodeTimeOnly()
4427 * Encode time fields only.
4428 *
4429 * tm and fsec are the value to encode, print_tz determines whether to include
4430 * a time zone (the difference between time and timetz types), tz is the
4431 * numeric time zone offset, style is the date style, str is where to write the
4432 * output.
4433 */
4434void
4435EncodeTimeOnly(struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, int style, char *str)
4436{
4437 str = pg_ultostr_zeropad(str, tm->tm_hour, 2);
4438 *str++ = ':';
4439 str = pg_ultostr_zeropad(str, tm->tm_min, 2);
4440 *str++ = ':';
4441 str = AppendSeconds(str, tm->tm_sec, fsec, MAX_TIME_PRECISION, true);
4442 if (print_tz)
4443 str = EncodeTimezone(str, tz, style);
4444 *str = '\0';
4445}
4446
4447
4448/* EncodeDateTime()
4449 * Encode date and time interpreted as local time.
4450 *
4451 * tm and fsec are the value to encode, print_tz determines whether to include
4452 * a time zone (the difference between timestamp and timestamptz types), tz is
4453 * the numeric time zone offset, tzn is the textual time zone, which if
4454 * specified will be used instead of tz by some styles, style is the date
4455 * style, str is where to write the output.
4456 *
4457 * Supported date styles:
4458 * Postgres - day mon hh:mm:ss yyyy tz
4459 * SQL - mm/dd/yyyy hh:mm:ss.ss tz
4460 * ISO - yyyy-mm-dd hh:mm:ss+/-tz
4461 * German - dd.mm.yyyy hh:mm:ss tz
4462 * XSD - yyyy-mm-ddThh:mm:ss.ss+/-tz
4463 */
4464void
4465EncodeDateTime(struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, const char *tzn, int style, char *str)
4466{
4467 int day;
4468
4469 Assert(tm->tm_mon >= 1 && tm->tm_mon <= MONTHS_PER_YEAR);
4470
4471 /*
4472 * Negative tm_isdst means we have no valid time zone translation.
4473 */
4474 if (tm->tm_isdst < 0)
4475 print_tz = false;
4476
4477 switch (style)
4478 {
4479 case USE_ISO_DATES:
4480 case USE_XSD_DATES:
4481 /* Compatible with ISO-8601 date formats */
4482 str = pg_ultostr_zeropad(str,
4483 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4484 *str++ = '-';
4485 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4486 *str++ = '-';
4487 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4488 *str++ = (style == USE_ISO_DATES) ? ' ' : 'T';
4489 str = pg_ultostr_zeropad(str, tm->tm_hour, 2);
4490 *str++ = ':';
4491 str = pg_ultostr_zeropad(str, tm->tm_min, 2);
4492 *str++ = ':';
4493 str = AppendTimestampSeconds(str, tm, fsec);
4494 if (print_tz)
4495 str = EncodeTimezone(str, tz, style);
4496 break;
4497
4498 case USE_SQL_DATES:
4499 /* Compatible with Oracle/Ingres date formats */
4500 if (DateOrder == DATEORDER_DMY)
4501 {
4502 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4503 *str++ = '/';
4504 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4505 }
4506 else
4507 {
4508 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4509 *str++ = '/';
4510 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4511 }
4512 *str++ = '/';
4513 str = pg_ultostr_zeropad(str,
4514 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4515 *str++ = ' ';
4516 str = pg_ultostr_zeropad(str, tm->tm_hour, 2);
4517 *str++ = ':';
4518 str = pg_ultostr_zeropad(str, tm->tm_min, 2);
4519 *str++ = ':';
4520 str = AppendTimestampSeconds(str, tm, fsec);
4521
4522 /*
4523 * Note: the uses of %.*s in this function would be risky if the
4524 * timezone names ever contain non-ASCII characters, since we are
4525 * not being careful to do encoding-aware clipping. However, all
4526 * TZ abbreviations in the IANA database are plain ASCII.
4527 */
4528 if (print_tz)
4529 {
4530 if (tzn)
4531 {
4532 sprintf(str, " %.*s", MAXTZLEN, tzn);
4533 str += strlen(str);
4534 }
4535 else
4536 str = EncodeTimezone(str, tz, style);
4537 }
4538 break;
4539
4540 case USE_GERMAN_DATES:
4541 /* German variant on European style */
4542 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4543 *str++ = '.';
4544 str = pg_ultostr_zeropad(str, tm->tm_mon, 2);
4545 *str++ = '.';
4546 str = pg_ultostr_zeropad(str,
4547 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4548 *str++ = ' ';
4549 str = pg_ultostr_zeropad(str, tm->tm_hour, 2);
4550 *str++ = ':';
4551 str = pg_ultostr_zeropad(str, tm->tm_min, 2);
4552 *str++ = ':';
4553 str = AppendTimestampSeconds(str, tm, fsec);
4554
4555 if (print_tz)
4556 {
4557 if (tzn)
4558 {
4559 sprintf(str, " %.*s", MAXTZLEN, tzn);
4560 str += strlen(str);
4561 }
4562 else
4563 str = EncodeTimezone(str, tz, style);
4564 }
4565 break;
4566
4567 case USE_POSTGRES_DATES:
4568 default:
4569 /* Backward-compatible with traditional Postgres abstime dates */
4570 day = date2j(tm->tm_year, tm->tm_mon, tm->tm_mday);
4571 tm->tm_wday = j2day(day);
4572 memcpy(str, days[tm->tm_wday], 3);
4573 str += 3;
4574 *str++ = ' ';
4575 if (DateOrder == DATEORDER_DMY)
4576 {
4577 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4578 *str++ = ' ';
4579 memcpy(str, months[tm->tm_mon - 1], 3);
4580 str += 3;
4581 }
4582 else
4583 {
4584 memcpy(str, months[tm->tm_mon - 1], 3);
4585 str += 3;
4586 *str++ = ' ';
4587 str = pg_ultostr_zeropad(str, tm->tm_mday, 2);
4588 }
4589 *str++ = ' ';
4590 str = pg_ultostr_zeropad(str, tm->tm_hour, 2);
4591 *str++ = ':';
4592 str = pg_ultostr_zeropad(str, tm->tm_min, 2);
4593 *str++ = ':';
4594 str = AppendTimestampSeconds(str, tm, fsec);
4595 *str++ = ' ';
4596 str = pg_ultostr_zeropad(str,
4597 (tm->tm_year > 0) ? tm->tm_year : -(tm->tm_year - 1), 4);
4598
4599 if (print_tz)
4600 {
4601 if (tzn)
4602 {
4603 sprintf(str, " %.*s", MAXTZLEN, tzn);
4604 str += strlen(str);
4605 }
4606 else
4607 {
4608 /*
4609 * We have a time zone, but no string version. Use the
4610 * numeric form, but be sure to include a leading space to
4611 * avoid formatting something which would be rejected by
4612 * the date/time parser later. - thomas 2001-10-19
4613 */
4614 *str++ = ' ';
4615 str = EncodeTimezone(str, tz, style);
4616 }
4617 }
4618 break;
4619 }
4620
4621 if (tm->tm_year <= 0)
4622 {
4623 memcpy(str, " BC", 3); /* Don't copy NUL */
4624 str += 3;
4625 }
4626 *str = '\0';
4627}
4628
4629
4630/*
4631 * Helper functions to avoid duplicated code in EncodeInterval.
4632 */
4633
4634/* Append an ISO-8601-style interval field, but only if value isn't zero */
4635static char *
4636AddISO8601IntPart(char *cp, int64 value, char units)
4637{
4638 if (value == 0)
4639 return cp;
4640 sprintf(cp, "%" PRId64 "%c", value, units);
4641 return cp + strlen(cp);
4642}
4643
4644/* Append a postgres-style interval field, but only if value isn't zero */
4645static char *
4646AddPostgresIntPart(char *cp, int64 value, const char *units,
4647 bool *is_zero, bool *is_before)
4648{
4649 if (value == 0)
4650 return cp;
4651 sprintf(cp, "%s%s%" PRId64 " %s%s",
4652 (!*is_zero) ? " " : "",
4653 (*is_before && value > 0) ? "+" : "",
4654 value,
4655 units,
4656 (value != 1) ? "s" : "");
4657
4658 /*
4659 * Each nonzero field sets is_before for (only) the next one. This is a
4660 * tad bizarre but it's how it worked before...
4661 */
4662 *is_before = (value < 0);
4663 *is_zero = false;
4664 return cp + strlen(cp);
4665}
4666
4667/* Append a verbose-style interval field, but only if value isn't zero */
4668static char *
4669AddVerboseIntPart(char *cp, int64 value, const char *units,
4670 bool *is_zero, bool *is_before)
4671{
4672 if (value == 0)
4673 return cp;
4674 /* first nonzero value sets is_before */
4675 if (*is_zero)
4676 {
4677 *is_before = (value < 0);
4678 value = i64abs(value);
4679 }
4680 else if (*is_before)
4681 value = -value;
4682 sprintf(cp, " %" PRId64 " %s%s", value, units, (value == 1) ? "" : "s");
4683 *is_zero = false;
4684 return cp + strlen(cp);
4685}
4686
4687
4688/* EncodeInterval()
4689 * Interpret time structure as a delta time and convert to string.
4690 *
4691 * Support "traditional Postgres" and ISO-8601 styles.
4692 * Actually, afaik ISO does not address time interval formatting,
4693 * but this looks similar to the spec for absolute date/time.
4694 * - thomas 1998-04-30
4695 *
4696 * Actually, afaik, ISO 8601 does specify formats for "time
4697 * intervals...[of the]...format with time-unit designators", which
4698 * are pretty ugly. The format looks something like
4699 * P1Y1M1DT1H1M1.12345S
4700 * but useful for exchanging data with computers instead of humans.
4701 * - ron 2003-07-14
4702 *
4703 * And ISO's SQL 2008 standard specifies standards for
4704 * "year-month literal"s (that look like '2-3') and
4705 * "day-time literal"s (that look like ('4 5:6:7')
4706 */
4707void
4708EncodeInterval(struct pg_itm *itm, int style, char *str)
4709{
4710 char *cp = str;
4711 int year = itm->tm_year;
4712 int mon = itm->tm_mon;
4713 int64 mday = itm->tm_mday; /* tm_mday could be INT_MIN */
4714 int64 hour = itm->tm_hour;
4715 int min = itm->tm_min;
4716 int sec = itm->tm_sec;
4717 int fsec = itm->tm_usec;
4718 bool is_before = false;
4719 bool is_zero = true;
4720
4721 /*
4722 * The sign of year and month are guaranteed to match, since they are
4723 * stored internally as "month". But we'll need to check for is_before and
4724 * is_zero when determining the signs of day and hour/minute/seconds
4725 * fields.
4726 */
4727 switch (style)
4728 {
4729 /* SQL Standard interval format */
4730 case INTSTYLE_SQL_STANDARD:
4731 {
4732 bool has_negative = year < 0 || mon < 0 ||
4733 mday < 0 || hour < 0 ||
4734 min < 0 || sec < 0 || fsec < 0;
4735 bool has_positive = year > 0 || mon > 0 ||
4736 mday > 0 || hour > 0 ||
4737 min > 0 || sec > 0 || fsec > 0;
4738 bool has_year_month = year != 0 || mon != 0;
4739 bool has_day_time = mday != 0 || hour != 0 ||
4740 min != 0 || sec != 0 || fsec != 0;
4741 bool has_day = mday != 0;
4742 bool sql_standard_value = !(has_negative && has_positive) &&
4743 !(has_year_month && has_day_time);
4744
4745 /*
4746 * SQL Standard wants only 1 "<sign>" preceding the whole
4747 * interval ... but can't do that if mixed signs.
4748 */
4749 if (has_negative && sql_standard_value)
4750 {
4751 *cp++ = '-';
4752 year = -year;
4753 mon = -mon;
4754 mday = -mday;
4755 hour = -hour;
4756 min = -min;
4757 sec = -sec;
4758 fsec = -fsec;
4759 }
4760
4761 if (!has_negative && !has_positive)
4762 {
4763 sprintf(cp, "0");
4764 }
4765 else if (!sql_standard_value)
4766 {
4767 /*
4768 * For non sql-standard interval values, force outputting
4769 * the signs to avoid ambiguities with intervals with
4770 * mixed sign components.
4771 */
4772 char year_sign = (year < 0 || mon < 0) ? '-' : '+';
4773 char day_sign = (mday < 0) ? '-' : '+';
4774 char sec_sign = (hour < 0 || min < 0 ||
4775 sec < 0 || fsec < 0) ? '-' : '+';
4776
4777 sprintf(cp, "%c%d-%d %c%" PRId64 " %c%" PRId64 ":%02d:",
4778 year_sign, abs(year), abs(mon),
4779 day_sign, i64abs(mday),
4780 sec_sign, i64abs(hour), abs(min));
4781 cp += strlen(cp);
4782 cp = AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
4783 *cp = '\0';
4784 }
4785 else if (has_year_month)
4786 {
4787 sprintf(cp, "%d-%d", year, mon);
4788 }
4789 else if (has_day)
4790 {
4791 sprintf(cp, "%" PRId64 " %" PRId64 ":%02d:",
4792 mday, hour, min);
4793 cp += strlen(cp);
4794 cp = AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
4795 *cp = '\0';
4796 }
4797 else
4798 {
4799 sprintf(cp, "%" PRId64 ":%02d:", hour, min);
4800 cp += strlen(cp);
4801 cp = AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
4802 *cp = '\0';
4803 }
4804 }
4805 break;
4806
4807 /* ISO 8601 "time-intervals by duration only" */
4808 case INTSTYLE_ISO_8601:
4809 /* special-case zero to avoid printing nothing */
4810 if (year == 0 && mon == 0 && mday == 0 &&
4811 hour == 0 && min == 0 && sec == 0 && fsec == 0)
4812 {
4813 sprintf(cp, "PT0S");
4814 break;
4815 }
4816 *cp++ = 'P';
4817 cp = AddISO8601IntPart(cp, year, 'Y');
4818 cp = AddISO8601IntPart(cp, mon, 'M');
4819 cp = AddISO8601IntPart(cp, mday, 'D');
4820 if (hour != 0 || min != 0 || sec != 0 || fsec != 0)
4821 *cp++ = 'T';
4822 cp = AddISO8601IntPart(cp, hour, 'H');
4823 cp = AddISO8601IntPart(cp, min, 'M');
4824 if (sec != 0 || fsec != 0)
4825 {
4826 if (sec < 0 || fsec < 0)
4827 *cp++ = '-';
4828 cp = AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, false);
4829 *cp++ = 'S';
4830 *cp++ = '\0';
4831 }
4832 break;
4833
4834 /* Compatible with postgresql < 8.4 when DateStyle = 'iso' */
4835 case INTSTYLE_POSTGRES:
4836 cp = AddPostgresIntPart(cp, year, "year", &is_zero, &is_before);
4837
4838 /*
4839 * Ideally we should spell out "month" like we do for "year" and
4840 * "day". However, for backward compatibility, we can't easily
4841 * fix this. bjm 2011-05-24
4842 */
4843 cp = AddPostgresIntPart(cp, mon, "mon", &is_zero, &is_before);
4844 cp = AddPostgresIntPart(cp, mday, "day", &is_zero, &is_before);
4845 if (is_zero || hour != 0 || min != 0 || sec != 0 || fsec != 0)
4846 {
4847 bool minus = (hour < 0 || min < 0 || sec < 0 || fsec < 0);
4848
4849 sprintf(cp, "%s%s%02" PRId64 ":%02d:",
4850 is_zero ? "" : " ",
4851 (minus ? "-" : (is_before ? "+" : "")),
4852 i64abs(hour), abs(min));
4853 cp += strlen(cp);
4854 cp = AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, true);
4855 *cp = '\0';
4856 }
4857 break;
4858
4859 /* Compatible with postgresql < 8.4 when DateStyle != 'iso' */
4860 case INTSTYLE_POSTGRES_VERBOSE:
4861 default:
4862 strcpy(cp, "@");
4863 cp++;
4864 cp = AddVerboseIntPart(cp, year, "year", &is_zero, &is_before);
4865 cp = AddVerboseIntPart(cp, mon, "mon", &is_zero, &is_before);
4866 cp = AddVerboseIntPart(cp, mday, "day", &is_zero, &is_before);
4867 cp = AddVerboseIntPart(cp, hour, "hour", &is_zero, &is_before);
4868 cp = AddVerboseIntPart(cp, min, "min", &is_zero, &is_before);
4869 if (sec != 0 || fsec != 0)
4870 {
4871 *cp++ = ' ';
4872 if (sec < 0 || (sec == 0 && fsec < 0))
4873 {
4874 if (is_zero)
4875 is_before = true;
4876 else if (!is_before)
4877 *cp++ = '-';
4878 }
4879 else if (is_before)
4880 *cp++ = '-';
4881 cp = AppendSeconds(cp, sec, fsec, MAX_INTERVAL_PRECISION, false);
4882 /* We output "ago", not negatives, so use abs(). */
4883 sprintf(cp, " sec%s",
4884 (abs(sec) != 1 || fsec != 0) ? "s" : "");
4885 is_zero = false;
4886 }
4887 /* identically zero? then put in a unitless zero... */
4888 if (is_zero)
4889 strcat(cp, " 0");
4890 if (is_before)
4891 strcat(cp, " ago");
4892 break;
4893 }
4894}
4895
4896
4897/*
4898 * We've been burnt by stupid errors in the ordering of the datetkn tables
4899 * once too often. Arrange to check them during postmaster start.
4900 */
4901static bool
4902CheckDateTokenTable(const char *tablename, const datetkn *base, int nel)
4903{
4904 bool ok = true;
4905 int i;
4906
4907 for (i = 0; i < nel; i++)
4908 {
4909 /* check for token strings that don't fit */
4910 if (strlen(base[i].token) > TOKMAXLEN)
4911 {
4912 /* %.*s is safe since all our tokens are ASCII */
4913 elog(LOG, "token too long in %s table: \"%.*s\"",
4914 tablename,
4915 TOKMAXLEN + 1, base[i].token);
4916 ok = false;
4917 break; /* don't risk applying strcmp */
4918 }
4919 /* check for out of order */
4920 if (i > 0 &&
4921 strcmp(base[i - 1].token, base[i].token) >= 0)
4922 {
4923 elog(LOG, "ordering error in %s table: \"%s\" >= \"%s\"",
4924 tablename,
4925 base[i - 1].token,
4926 base[i].token);
4927 ok = false;
4928 }
4929 }
4930 return ok;
4931}
4932
4933bool
4934CheckDateTokenTables(void)
4935{
4936 bool ok = true;
4937
4938 Assert(UNIX_EPOCH_JDATE == date2j(1970, 1, 1));
4939 Assert(POSTGRES_EPOCH_JDATE == date2j(2000, 1, 1));
4940
4941 ok &= CheckDateTokenTable("datetktbl", datetktbl, szdatetktbl);
4942 ok &= CheckDateTokenTable("deltatktbl", deltatktbl, szdeltatktbl);
4943 return ok;
4944}
4945
4946/*
4947 * Common code for temporal prosupport functions: simplify, if possible,
4948 * a call to a temporal type's length-coercion function.
4949 *
4950 * Types time, timetz, timestamp and timestamptz each have a range of allowed
4951 * precisions. An unspecified precision is rigorously equivalent to the
4952 * highest specifiable precision. We can replace the function call with a
4953 * no-op RelabelType if it is coercing to the same or higher precision as the
4954 * input is known to have.
4955 *
4956 * The input Node is always a FuncExpr, but to reduce the #include footprint
4957 * of datetime.h, we declare it as Node *.
4958 *
4959 * Note: timestamp_scale throws an error when the typmod is out of range, but
4960 * we can't get there from a cast: our typmodin will have caught it already.
4961 */
4962Node *
4963TemporalSimplify(int32 max_precis, Node *node)
4964{
4965 FuncExpr *expr = castNode(FuncExpr, node);
4966 Node *ret = NULL;
4967 Node *typmod;
4968
4969 Assert(list_length(expr->args) >= 2);
4970
4971 typmod = (Node *) lsecond(expr->args);
4972
4973 if (IsA(typmod, Const) && !((Const *) typmod)->constisnull)
4974 {
4975 Node *source = (Node *) linitial(expr->args);
4976 int32 old_precis = exprTypmod(source);
4977 int32 new_precis = DatumGetInt32(((Const *) typmod)->constvalue);
4978
4979 if (new_precis < 0 || new_precis == max_precis ||
4980 (old_precis >= 0 && new_precis >= old_precis))
4981 ret = relabel_to_typmod(source, new_precis);
4982 }
4983
4984 return ret;
4985}
4986
4987/*
4988 * This function gets called during timezone config file load or reload
4989 * to create the final array of timezone tokens. The argument array
4990 * is already sorted in name order.
4991 *
4992 * The result is a TimeZoneAbbrevTable (which must be a single guc_malloc'd
4993 * chunk) or NULL on alloc failure. No other error conditions are defined.
4994 */
4995TimeZoneAbbrevTable *
4996ConvertTimeZoneAbbrevs(struct tzEntry *abbrevs, int n)
4997{
4998 TimeZoneAbbrevTable *tbl;
4999 Size tbl_size;
5000 int i;
5001
5002 /* Space for fixed fields and datetkn array */
5003 tbl_size = offsetof(TimeZoneAbbrevTable, abbrevs) +
5004 n * sizeof(datetkn);
5005 tbl_size = MAXALIGN(tbl_size);
5006 /* Count up space for dynamic abbreviations */
5007 for (i = 0; i < n; i++)
5008 {
5009 struct tzEntry *abbr = abbrevs + i;
5010
5011 if (abbr->zone != NULL)
5012 {
5013 Size dsize;
5014
5015 dsize = offsetof(DynamicZoneAbbrev, zone) +
5016 strlen(abbr->zone) + 1;
5017 tbl_size += MAXALIGN(dsize);
5018 }
5019 }
5020
5021 /* Alloc the result ... */
5022 tbl = guc_malloc(LOG, tbl_size);
5023 if (!tbl)
5024 return NULL;
5025
5026 /* ... and fill it in */
5027 tbl->tblsize = tbl_size;
5028 tbl->numabbrevs = n;
5029 /* in this loop, tbl_size reprises the space calculation above */
5030 tbl_size = offsetof(TimeZoneAbbrevTable, abbrevs) +
5031 n * sizeof(datetkn);
5032 tbl_size = MAXALIGN(tbl_size);
5033 for (i = 0; i < n; i++)
5034 {
5035 struct tzEntry *abbr = abbrevs + i;
5036 datetkn *dtoken = tbl->abbrevs + i;
5037
5038 /* use strlcpy to truncate name if necessary */
5039 strlcpy(dtoken->token, abbr->abbrev, TOKMAXLEN + 1);
5040 if (abbr->zone != NULL)
5041 {
5042 /* Allocate a DynamicZoneAbbrev for this abbreviation */
5043 DynamicZoneAbbrev *dtza;
5044 Size dsize;
5045
5046 dtza = (DynamicZoneAbbrev *) ((char *) tbl + tbl_size);
5047 dtza->tz = NULL;
5048 strcpy(dtza->zone, abbr->zone);
5049
5050 dtoken->type = DYNTZ;
5051 /* value is offset from table start to DynamicZoneAbbrev */
5052 dtoken->value = (int32) tbl_size;
5053
5054 dsize = offsetof(DynamicZoneAbbrev, zone) +
5055 strlen(abbr->zone) + 1;
5056 tbl_size += MAXALIGN(dsize);
5057 }
5058 else
5059 {
5060 dtoken->type = abbr->is_dst ? DTZ : TZ;
5061 dtoken->value = abbr->offset;
5062 }
5063 }
5064
5065 /* Assert the two loops above agreed on size calculations */
5066 Assert(tbl->tblsize == tbl_size);
5067
5068 /* Check the ordering, if testing */
5069 Assert(CheckDateTokenTable("timezone abbreviations", tbl->abbrevs, n));
5070
5071 return tbl;
5072}
5073
5074/*
5075 * Install a TimeZoneAbbrevTable as the active table.
5076 *
5077 * Caller is responsible that the passed table doesn't go away while in use.
5078 */
5079void
5080InstallTimeZoneAbbrevs(TimeZoneAbbrevTable *tbl)
5081{
5082 zoneabbrevtbl = tbl;
5083 /* reset tzabbrevcache, which may contain results from old table */
5084 memset(tzabbrevcache, 0, sizeof(tzabbrevcache));
5085}
5086
5087/*
5088 * Helper subroutine to locate pg_tz timezone for a dynamic abbreviation.
5089 *
5090 * On failure, returns NULL and fills *extra for a DTERR_BAD_ZONE_ABBREV error.
5091 */
5092static pg_tz *
5093FetchDynamicTimeZone(TimeZoneAbbrevTable *tbl, const datetkn *tp,
5094 DateTimeErrorExtra *extra)
5095{
5096 DynamicZoneAbbrev *dtza;
5097
5098 /* Just some sanity checks to prevent indexing off into nowhere */
5099 Assert(tp->type == DYNTZ);
5100 Assert(tp->value > 0 && tp->value < tbl->tblsize);
5101
5102 dtza = (DynamicZoneAbbrev *) ((char *) tbl + tp->value);
5103
5104 /* Look up the underlying zone if we haven't already */
5105 if (dtza->tz == NULL)
5106 {
5107 dtza->tz = pg_tzset(dtza->zone);
5108 if (dtza->tz == NULL)
5109 {
5110 /* Ooops, bogus zone name in config file entry */
5111 extra->dtee_timezone = dtza->zone;
5112 extra->dtee_abbrev = tp->token;
5113 }
5114 }
5115 return dtza->tz;
5116}
5117
5118
5119/*
5120 * This set-returning function reads all the time zone abbreviations
5121 * defined by the IANA data for the current timezone setting,
5122 * and returns a set of (abbrev, utc_offset, is_dst).
5123 */
5124Datum
5125pg_timezone_abbrevs_zone(PG_FUNCTION_ARGS)
5126{
5127 FuncCallContext *funcctx;
5128 int *pindex;
5129 Datum result;
5130 HeapTuple tuple;
5131 Datum values[3];
5132 bool nulls[3] = {0};
5133 TimestampTz now = GetCurrentTransactionStartTimestamp();
5134 pg_time_t t = timestamptz_to_time_t(now);
5135 const char *abbrev;
5136 long int gmtoff;
5137 int isdst;
5138 struct pg_itm_in itm_in;
5139 Interval *resInterval;
5140
5141 /* stuff done only on the first call of the function */
5142 if (SRF_IS_FIRSTCALL())
5143 {
5144 TupleDesc tupdesc;
5145 MemoryContext oldcontext;
5146
5147 /* create a function context for cross-call persistence */
5148 funcctx = SRF_FIRSTCALL_INIT();
5149
5150 /*
5151 * switch to memory context appropriate for multiple function calls
5152 */
5153 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
5154
5155 /* allocate memory for user context */
5156 pindex = palloc_object(int);
5157 *pindex = 0;
5158 funcctx->user_fctx = pindex;
5159
5160 if (get_call_result_type(fcinfo, NULL, &tupdesc) != TYPEFUNC_COMPOSITE)
5161 elog(ERROR, "return type must be a row type");
5162 funcctx->tuple_desc = tupdesc;
5163
5164 MemoryContextSwitchTo(oldcontext);
5165 }
5166
5167 /* stuff done on every call of the function */
5168 funcctx = SRF_PERCALL_SETUP();
5169 pindex = (int *) funcctx->user_fctx;
5170
5171 while ((abbrev = pg_get_next_timezone_abbrev(pindex,
5172 session_timezone)) != NULL)
5173 {
5174 /* Ignore abbreviations that aren't all-alphabetic */
5175 if (strspn(abbrev, "ABCDEFGHIJKLMNOPQRSTUVWXYZ") != strlen(abbrev))
5176 continue;
5177
5178 /* Determine the current meaning of the abbrev */
5179 if (!pg_interpret_timezone_abbrev(abbrev,
5180 &t,
5181 &gmtoff,
5182 &isdst,
5183 session_timezone))
5184 continue; /* hm, not actually used in this zone? */
5185
5186 values[0] = CStringGetTextDatum(abbrev);
5187
5188 /* Convert offset (in seconds) to an interval; can't overflow */
5189 MemSet(&itm_in, 0, sizeof(struct pg_itm_in));
5190 itm_in.tm_usec = (int64) gmtoff * USECS_PER_SEC;
5191 resInterval = palloc_object(Interval);
5192 (void) itmin2interval(&itm_in, resInterval);
5193 values[1] = IntervalPGetDatum(resInterval);
5194
5195 values[2] = BoolGetDatum(isdst);
5196
5197 tuple = heap_form_tuple(funcctx->tuple_desc, values, nulls);
5198 result = HeapTupleGetDatum(tuple);
5199
5200 SRF_RETURN_NEXT(funcctx, result);
5201 }
5202
5203 SRF_RETURN_DONE(funcctx);
5204}
5205
5206/*
5207 * This set-returning function reads all the time zone abbreviations
5208 * defined by the timezone_abbreviations setting,
5209 * and returns a set of (abbrev, utc_offset, is_dst).
5210 */
5211Datum
5212pg_timezone_abbrevs_abbrevs(PG_FUNCTION_ARGS)
5213{
5214 FuncCallContext *funcctx;
5215 int *pindex;
5216 Datum result;
5217 HeapTuple tuple;
5218 Datum values[3];
5219 bool nulls[3] = {0};
5220 const datetkn *tp;
5221 char buffer[TOKMAXLEN + 1];
5222 int gmtoffset;
5223 bool is_dst;
5224 unsigned char *p;
5225 struct pg_itm_in itm_in;
5226 Interval *resInterval;
5227
5228 /* stuff done only on the first call of the function */
5229 if (SRF_IS_FIRSTCALL())
5230 {
5231 TupleDesc tupdesc;
5232 MemoryContext oldcontext;
5233
5234 /* create a function context for cross-call persistence */
5235 funcctx = SRF_FIRSTCALL_INIT();
5236
5237 /*
5238 * switch to memory context appropriate for multiple function calls
5239 */
5240 oldcontext = MemoryContextSwitchTo(funcctx->multi_call_memory_ctx);
5241
5242 /* allocate memory for user context */
5243 pindex = palloc_object(int);
5244 *pindex = 0;
5245 funcctx->user_fctx = pindex;
5246
5247 if (get_call_result_type(fcinfo, NULL, &tupdesc) != TYPEFUNC_COMPOSITE)
5248 elog(ERROR, "return type must be a row type");
5249 funcctx->tuple_desc = tupdesc;
5250
5251 MemoryContextSwitchTo(oldcontext);
5252 }
5253
5254 /* stuff done on every call of the function */
5255 funcctx = SRF_PERCALL_SETUP();
5256 pindex = (int *) funcctx->user_fctx;
5257
5258 if (zoneabbrevtbl == NULL ||
5259 *pindex >= zoneabbrevtbl->numabbrevs)
5260 SRF_RETURN_DONE(funcctx);
5261
5262 tp = zoneabbrevtbl->abbrevs + *pindex;
5263
5264 switch (tp->type)
5265 {
5266 case TZ:
5267 gmtoffset = tp->value;
5268 is_dst = false;
5269 break;
5270 case DTZ:
5271 gmtoffset = tp->value;
5272 is_dst = true;
5273 break;
5274 case DYNTZ:
5275 {
5276 /* Determine the current meaning of the abbrev */
5277 pg_tz *tzp;
5278 DateTimeErrorExtra extra;
5279 TimestampTz now;
5280 int isdst;
5281
5282 tzp = FetchDynamicTimeZone(zoneabbrevtbl, tp, &extra);
5283 if (tzp == NULL)
5284 DateTimeParseError(DTERR_BAD_ZONE_ABBREV, &extra,
5285 NULL, NULL, NULL);
5286 now = GetCurrentTransactionStartTimestamp();
5287 gmtoffset = -DetermineTimeZoneAbbrevOffsetTS(now,
5288 tp->token,
5289 tzp,
5290 &isdst);
5291 is_dst = (bool) isdst;
5292 break;
5293 }
5294 default:
5295 elog(ERROR, "unrecognized timezone type %d", (int) tp->type);
5296 gmtoffset = 0; /* keep compiler quiet */
5297 is_dst = false;
5298 break;
5299 }
5300
5301 /*
5302 * Convert name to text, using upcasing conversion that is the inverse of
5303 * what ParseDateTime() uses.
5304 */
5305 strlcpy(buffer, tp->token, sizeof(buffer));
5306 for (p = (unsigned char *) buffer; *p; p++)
5307 *p = pg_toupper(*p);
5308
5309 values[0] = CStringGetTextDatum(buffer);
5310
5311 /* Convert offset (in seconds) to an interval; can't overflow */
5312 MemSet(&itm_in, 0, sizeof(struct pg_itm_in));
5313 itm_in.tm_usec = (int64) gmtoffset * USECS_PER_SEC;
5314 resInterval = palloc_object(Interval);
5315 (void) itmin2interval(&itm_in, resInterval);
5316 values[1] = IntervalPGetDatum(resInterval);
5317
5318 values[2] = BoolGetDatum(is_dst);
5319
5320 (*pindex)++;
5321
5322 tuple = heap_form_tuple(funcctx->tuple_desc, values, nulls);
5323 result = HeapTupleGetDatum(tuple);
5324
5325 SRF_RETURN_NEXT(funcctx, result);
5326}
5327
5328/*
5329 * This set-returning function reads all the available full time zones
5330 * and returns a set of (name, abbrev, utc_offset, is_dst).
5331 */
5332Datum
5333pg_timezone_names(PG_FUNCTION_ARGS)
5334{
5335 ReturnSetInfo *rsinfo = (ReturnSetInfo *) fcinfo->resultinfo;
5336 pg_tzenum *tzenum;
5337 pg_tz *tz;
5338 Datum values[4];
5339 bool nulls[4] = {0};
5340 int tzoff;
5341 struct pg_tm tm;
5342 fsec_t fsec;
5343 const char *tzn;
5344 Interval *resInterval;
5345 struct pg_itm_in itm_in;
5346
5347 InitMaterializedSRF(fcinfo, 0);
5348
5349 /* initialize timezone scanning code */
5350 tzenum = pg_tzenumerate_start();
5351
5352 /* search for another zone to display */
5353 for (;;)
5354 {
5355 tz = pg_tzenumerate_next(tzenum);
5356 if (!tz)
5357 break;
5358
5359 /* Convert now() to local time in this zone */
5360 if (timestamp2tm(GetCurrentTransactionStartTimestamp(),
5361 &tzoff, &tm, &fsec, &tzn, tz) != 0)
5362 continue; /* ignore if conversion fails */
5363
5364 /*
5365 * IANA's rather silly "Factory" time zone used to emit ridiculously
5366 * long "abbreviations" such as "Local time zone must be set--see zic
5367 * manual page" or "Local time zone must be set--use tzsetup". While
5368 * modern versions of tzdb emit the much saner "-00", it seems some
5369 * benighted packagers are hacking the IANA data so that it continues
5370 * to produce these strings. To prevent producing a weirdly wide
5371 * abbrev column, reject ridiculously long abbreviations.
5372 */
5373 if (tzn && strlen(tzn) > 31)
5374 continue;
5375
5376 values[0] = CStringGetTextDatum(pg_get_timezone_name(tz));
5377 values[1] = CStringGetTextDatum(tzn ? tzn : "");
5378
5379 /* Convert tzoff to an interval; can't overflow */
5380 MemSet(&itm_in, 0, sizeof(struct pg_itm_in));
5381 itm_in.tm_usec = (int64) -tzoff * USECS_PER_SEC;
5382 resInterval = palloc_object(Interval);
5383 (void) itmin2interval(&itm_in, resInterval);
5384 values[2] = IntervalPGetDatum(resInterval);
5385
5386 values[3] = BoolGetDatum(tm.tm_isdst > 0);
5387
5388 tuplestore_putvalues(rsinfo->setResult, rsinfo->setDesc, values, nulls);
5389 }
5390
5391 pg_tzenumerate_end(tzenum);
5392 return (Datum) 0;
5393}
EncodeTimezone
static char * EncodeTimezone(char *str, int tz, int style)
Definition datetime.c:4312
DecodeDate
static int DecodeDate(char *str, int fmask, int *tmask, bool *is2digits, struct pg_tm *tm)
Definition datetime.c:2452
day_tab
const int day_tab[2][13]
Definition datetime.c:76
DetermineTimeZoneOffsetInternal
static int DetermineTimeZoneOffsetInternal(struct pg_tm *tm, pg_tz *tzp, pg_time_t *tp)
Definition datetime.c:1627
APPEND_CHAR
#define APPEND_CHAR(bufptr, end, newchar)
DecodeNumberField
static int DecodeNumberField(int len, char *str, int fmask, int *tmask, struct pg_tm *tm, fsec_t *fsec, bool *is2digits)
Definition datetime.c:2966
TemporalSimplify
Node * TemporalSimplify(int32 max_precis, Node *node)
Definition datetime.c:4963
DecodeTimezoneNameToTz
pg_tz * DecodeTimezoneNameToTz(const char *tzname)
Definition datetime.c:3344
CheckDateTokenTable
static bool CheckDateTokenTable(const char *tablename, const datetkn *base, int nel)
Definition datetime.c:4902
DetermineTimeZoneAbbrevOffsetTS
int DetermineTimeZoneAbbrevOffsetTS(TimestampTz ts, const char *abbr, pg_tz *tzp, int *isdst)
Definition datetime.c:1804
ParseFraction
static int ParseFraction(char *cp, double *frac)
Definition datetime.c:691
tzabbrevcache
static TzAbbrevCache tzabbrevcache[MAXDATEFIELDS]
Definition datetime.c:273
InstallTimeZoneAbbrevs
void InstallTimeZoneAbbrevs(TimeZoneAbbrevTable *tbl)
Definition datetime.c:5080
datetktbl
static const datetkn datetktbl[]
Definition datetime.c:106
int64_multiply_add
static bool int64_multiply_add(int64 val, int64 multiplier, int64 *sum)
Definition datetime.c:533
DecodeUnits
int DecodeUnits(int field, const char *lowtoken, int *val)
Definition datetime.c:4170
DecodeTimeOnly
int DecodeTimeOnly(char **field, int *ftype, int nf, int *dtype, struct pg_tm *tm, fsec_t *fsec, int *tzp, DateTimeErrorExtra *extra)
Definition datetime.c:1918
zoneabbrevtbl
static TimeZoneAbbrevTable * zoneabbrevtbl
Definition datetime.c:255
deltacache
static const datetkn * deltacache[MAXDATEFIELDS]
Definition datetime.c:261
j2day
int j2day(int date)
Definition datetime.c:355
ParseDateTime
int ParseDateTime(const char *timestr, char *workbuf, size_t buflen, char **field, int *ftype, int maxfields, int *numfields)
Definition datetime.c:774
EncodeInterval
void EncodeInterval(struct pg_itm *itm, int style, char *str)
Definition datetime.c:4708
AdjustDays
static bool AdjustDays(int64 val, int scale, struct pg_itm_in *itm_in)
Definition datetime.c:644
datecache
static const datetkn * datecache[MAXDATEFIELDS]
Definition datetime.c:259
DecodeNumber
static int DecodeNumber(int flen, char *str, bool haveTextMonth, int fmask, int *tmask, struct pg_tm *tm, fsec_t *fsec, bool *is2digits)
Definition datetime.c:2781
DetermineTimeZoneOffset
int DetermineTimeZoneOffset(struct pg_tm *tm, pg_tz *tzp)
Definition datetime.c:1605
DetermineTimeZoneAbbrevOffsetInternal
static bool DetermineTimeZoneAbbrevOffsetInternal(pg_time_t t, const char *abbr, pg_tz *tzp, int *offset, int *isdst)
Definition datetime.c:1841
DateTimeParseError
void DateTimeParseError(int dterr, DateTimeErrorExtra *extra, const char *str, const char *datatype, Node *escontext)
Definition datetime.c:4215
ParseFractionalSecond
static int ParseFractionalSecond(char *cp, fsec_t *fsec)
Definition datetime.c:729
AdjustFractYears
static bool AdjustFractYears(double frac, int scale, struct pg_itm_in *itm_in)
Definition datetime.c:612
AdjustMicroseconds
static bool AdjustMicroseconds(int64 val, double fval, int64 scale, struct pg_itm_in *itm_in)
Definition datetime.c:629
DecodeTimeCommon
static int DecodeTimeCommon(char *str, int fmask, int range, int *tmask, struct pg_itm *itm)
Definition datetime.c:2644
DecodeInterval
int DecodeInterval(char **field, int *ftype, int nf, int range, int *dtype, struct pg_itm_in *itm_in)
Definition datetime.c:3487
pg_timezone_abbrevs_abbrevs
Datum pg_timezone_abbrevs_abbrevs(PG_FUNCTION_ARGS)
Definition datetime.c:5212
DecodeTimeForInterval
static int DecodeTimeForInterval(char *str, int fmask, int range, int *tmask, struct pg_itm_in *itm_in)
Definition datetime.c:2755
AddPostgresIntPart
static char * AddPostgresIntPart(char *cp, int64 value, const char *units, bool *is_zero, bool *is_before)
Definition datetime.c:4646
CheckDateTokenTables
bool CheckDateTokenTables(void)
Definition datetime.c:4934
szdeltatktbl
static const int szdeltatktbl
Definition datetime.c:253
DecodeTimezoneAbbrev
int DecodeTimezoneAbbrev(int field, const char *lowtoken, int *ftype, int *offset, pg_tz **tz, DateTimeErrorExtra *extra)
Definition datetime.c:3142
pg_timezone_names
Datum pg_timezone_names(PG_FUNCTION_ARGS)
Definition datetime.c:5333
EncodeTimeOnly
void EncodeTimeOnly(struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, int style, char *str)
Definition datetime.c:4435
DecodeTime
static int DecodeTime(char *str, int fmask, int range, int *tmask, struct pg_tm *tm, fsec_t *fsec)
Definition datetime.c:2726
AdjustFractMicroseconds
static bool AdjustFractMicroseconds(double frac, int64 scale, struct pg_itm_in *itm_in)
Definition datetime.c:548
DecodeISO8601Interval
int DecodeISO8601Interval(char *str, int *dtype, struct pg_itm_in *itm_in)
Definition datetime.c:3952
ValidateDate
int ValidateDate(int fmask, bool isjulian, bool is2digits, bool bc, struct pg_tm *tm)
Definition datetime.c:2562
DecodeSpecial
int DecodeSpecial(int field, const char *lowtoken, int *val)
Definition datetime.c:3247
j2date
void j2date(int jd, int *year, int *month, int *day)
Definition datetime.c:322
GetCurrentDateTime
void GetCurrentDateTime(struct pg_tm *tm)
Definition datetime.c:377
ISO8601IntegerWidth
static int ISO8601IntegerWidth(char *fieldstart)
Definition datetime.c:3925
AdjustYears
static bool AdjustYears(int64 val, int scale, struct pg_itm_in *itm_in)
Definition datetime.c:672
EncodeDateTime
void EncodeDateTime(struct pg_tm *tm, fsec_t fsec, bool print_tz, int tz, const char *tzn, int style, char *str)
Definition datetime.c:4465
DecodeTimezone
int DecodeTimezone(const char *str, int *tzp)
Definition datetime.c:3058
ConvertTimeZoneAbbrevs
TimeZoneAbbrevTable * ConvertTimeZoneAbbrevs(struct tzEntry *abbrevs, int n)
Definition datetime.c:4996
months
const char *const months[]
Definition datetime.c:82
AdjustMonths
static bool AdjustMonths(int64 val, struct pg_itm_in *itm_in)
Definition datetime.c:660
AppendSeconds
static char * AppendSeconds(char *cp, int sec, fsec_t fsec, int precision, bool fillzeros)
Definition datetime.c:459
szdatetktbl
static const int szdatetktbl
Definition datetime.c:182
pg_timezone_abbrevs_zone
Datum pg_timezone_abbrevs_zone(PG_FUNCTION_ARGS)
Definition datetime.c:5125
EncodeDateOnly
void EncodeDateOnly(struct pg_tm *tm, int style, char *str)
Definition datetime.c:4350
AppendTimestampSeconds
static char * AppendTimestampSeconds(char *cp, struct pg_tm *tm, fsec_t fsec)
Definition datetime.c:522
datebsearch
static const datetkn * datebsearch(const char *key, const datetkn *base, int nel)
Definition datetime.c:4276
AddISO8601IntPart
static char * AddISO8601IntPart(char *cp, int64 value, char units)
Definition datetime.c:4636
ParseISO8601Number
static int ParseISO8601Number(char *str, char **endptr, int64 *ipart, double *fpart)
Definition datetime.c:3883
DecodeDateTime
int DecodeDateTime(char **field, int *ftype, int nf, int *dtype, struct pg_tm *tm, fsec_t *fsec, int *tzp, DateTimeErrorExtra *extra)
Definition datetime.c:998
date2j
int date2j(int year, int month, int day)
Definition datetime.c:297
TimeZoneAbbrevIsKnown
static bool TimeZoneAbbrevIsKnown(const char *abbr, pg_tz *tzp, bool *isfixed, int *offset, int *isdst)
Definition datetime.c:1875
AdjustFractDays
static bool AdjustFractDays(double frac, int scale, struct pg_itm_in *itm_in)
Definition datetime.c:580
ClearPgItmIn
static void ClearPgItmIn(struct pg_itm_in *itm_in)
Definition datetime.c:3463
AddVerboseIntPart
static char * AddVerboseIntPart(char *cp, int64 value, const char *units, bool *is_zero, bool *is_before)
Definition datetime.c:4669
deltatktbl
static const datetkn deltatktbl[]
Definition datetime.c:188
GetCurrentTimeUsec
void GetCurrentTimeUsec(struct pg_tm *tm, fsec_t *fsec, int *tzp)
Definition datetime.c:398
days
const char *const days[]
Definition datetime.c:85
FetchDynamicTimeZone
static pg_tz * FetchDynamicTimeZone(TimeZoneAbbrevTable *tbl, const datetkn *tp, DateTimeErrorExtra *extra)
Definition datetime.c:5093
ClearTimeZoneAbbrevCache
void ClearTimeZoneAbbrevCache(void)
Definition datetime.c:3228
DecodeTimezoneName
int DecodeTimezoneName(const char *tzname, int *offset, pg_tz **tz)
Definition datetime.c:3289
DecodeTimezoneAbbrevPrefix
int DecodeTimezoneAbbrevPrefix(const char *str, int *offset, pg_tz **tz)
Definition datetime.c:3372
DetermineTimeZoneAbbrevOffset
int DetermineTimeZoneAbbrevOffset(struct pg_tm *tm, const char *abbr, pg_tz *tzp)
Definition datetime.c:1766
dt2time
void dt2time(Timestamp jd, int *hour, int *min, int *sec, fsec_t *fsec)
Definition timestamp.c:1874
itmin2interval
int itmin2interval(struct pg_itm_in *itm_in, Interval *span)
Definition timestamp.c:2106
timestamp2tm
int timestamp2tm(Timestamp dt, int *tzp, struct pg_tm *tm, fsec_t *fsec, const char **tzn, pg_tz *attimezone)
Definition timestamp.c:1901
now
Datum now(PG_FUNCTION_ARGS)
Definition timestamp.c:1600
timestamptz_to_time_t
pg_time_t timestamptz_to_time_t(TimestampTz t)
Definition timestamp.c:1833
values
static Datum values[MAXATTR]
Definition bootstrap.c:188
CStringGetTextDatum
#define CStringGetTextDatum(s)
Definition builtins.h:98
MAXALIGN
#define MAXALIGN(LEN)
Definition c.h:898
Assert
#define Assert(condition)
Definition c.h:945
int64
int64_t int64
Definition c.h:615
int32
int32_t int32
Definition c.h:614
PG_INT64_MIN
#define PG_INT64_MIN
Definition c.h:677
pg_fallthrough
#define pg_fallthrough
Definition c.h:152
MemSet
#define MemSet(start, val, len)
Definition c.h:1109
Size
size_t Size
Definition c.h:691
TimestampTz
int64 TimestampTz
Definition timestamp.h:39
SECS_PER_HOUR
#define SECS_PER_HOUR
Definition timestamp.h:127
MAX_TIMESTAMP_PRECISION
#define MAX_TIMESTAMP_PRECISION
Definition timestamp.h:92
MAX_TZDISP_HOUR
#define MAX_TZDISP_HOUR
Definition timestamp.h:143
fsec_t
int32 fsec_t
Definition timestamp.h:41
USECS_PER_HOUR
#define USECS_PER_HOUR
Definition timestamp.h:132
MONTHS_PER_YEAR
#define MONTHS_PER_YEAR
Definition timestamp.h:108
MINS_PER_HOUR
#define MINS_PER_HOUR
Definition timestamp.h:129
IS_VALID_JULIAN
#define IS_VALID_JULIAN(y, m, d)
Definition timestamp.h:227
MAX_INTERVAL_PRECISION
#define MAX_INTERVAL_PRECISION
Definition timestamp.h:93
SECS_PER_MINUTE
#define SECS_PER_MINUTE
Definition timestamp.h:128
USECS_PER_DAY
#define USECS_PER_DAY
Definition timestamp.h:131
USECS_PER_SEC
#define USECS_PER_SEC
Definition timestamp.h:134
HOURS_PER_DAY
#define HOURS_PER_DAY
Definition timestamp.h:118
USECS_PER_MINUTE
#define USECS_PER_MINUTE
Definition timestamp.h:133
DAYS_PER_MONTH
#define DAYS_PER_MONTH
Definition timestamp.h:116
UNIX_EPOCH_JDATE
#define UNIX_EPOCH_JDATE
Definition timestamp.h:234
SECS_PER_DAY
#define SECS_PER_DAY
Definition timestamp.h:126
POSTGRES_EPOCH_JDATE
#define POSTGRES_EPOCH_JDATE
Definition timestamp.h:235
time_overflows
bool time_overflows(int hour, int min, int sec, fsec_t fsec)
Definition date.c:1515
MAX_TIME_PRECISION
#define MAX_TIME_PRECISION
Definition date.h:51
errcode
int errcode(int sqlerrcode)
Definition elog.c:874
LOG
#define LOG
Definition elog.h:31
errsave
#define errsave(context,...)
Definition elog.h:262
errhint
int errhint(const char *fmt,...) pg_attribute_printf(1
errdetail
int errdetail(const char *fmt,...) pg_attribute_printf(1
ERROR
#define ERROR
Definition elog.h:39
elog
#define elog(elevel,...)
Definition elog.h:226
ereport
#define ereport(elevel,...)
Definition elog.h:150
palloc_object
#define palloc_object(type)
Definition fe_memutils.h:74
PG_FUNCTION_ARGS
#define PG_FUNCTION_ARGS
Definition fmgr.h:193
InitMaterializedSRF
void InitMaterializedSRF(FunctionCallInfo fcinfo, bits32 flags)
Definition funcapi.c:76
get_call_result_type
TypeFuncClass get_call_result_type(FunctionCallInfo fcinfo, Oid *resultTypeId, TupleDesc *resultTupleDesc)
Definition funcapi.c:276
SRF_IS_FIRSTCALL
#define SRF_IS_FIRSTCALL()
Definition funcapi.h:304
SRF_PERCALL_SETUP
#define SRF_PERCALL_SETUP()
Definition funcapi.h:308
TYPEFUNC_COMPOSITE
@ TYPEFUNC_COMPOSITE
Definition funcapi.h:149
SRF_RETURN_NEXT
#define SRF_RETURN_NEXT(_funcctx, _result)
Definition funcapi.h:310
SRF_FIRSTCALL_INIT
#define SRF_FIRSTCALL_INIT()
Definition funcapi.h:306
HeapTupleGetDatum
static Datum HeapTupleGetDatum(const HeapTupleData *tuple)
Definition funcapi.h:230
SRF_RETURN_DONE
#define SRF_RETURN_DONE(_funcctx)
Definition funcapi.h:328
IntervalStyle
int IntervalStyle
Definition globals.c:127
DateOrder
int DateOrder
Definition globals.c:126
guc_malloc
void * guc_malloc(int elevel, size_t size)
Definition guc.c:637
str
const char * str
Definition hashfn_unstable.h:261
remainder
size_t remainder
Definition hashfn_unstable.h:263
heap_form_tuple
HeapTuple heap_form_tuple(TupleDesc tupleDescriptor, const Datum *values, const bool *isnull)
Definition heaptuple.c:1037
htup_details.h
MAXDATEFIELDS
#define MAXDATEFIELDS
Definition datetime.h:202
DTK_TOMORROW
#define DTK_TOMORROW
Definition datetime.h:156
DAGO
#define DAGO
Definition datetime.h:35
EPOCH
#define EPOCH
Definition datetime.h:37
DTK_EPOCH
#define DTK_EPOCH
Definition datetime.h:152
DYEAR
#define DYEAR
Definition datetime.h:56
DTK_SPECIAL
#define DTK_SPECIAL
Definition datetime.h:149
MILLENNIUM
#define MILLENNIUM
Definition datetime.h:120
AMPM
#define AMPM
Definition datetime.h:99
DTERR_BAD_ZONE_ABBREV
#define DTERR_BAD_ZONE_ABBREV
Definition datetime.h:288
DTK_TIME
#define DTK_TIME
Definition datetime.h:145
UNKNOWN_FIELD
#define UNKNOWN_FIELD
Definition datetime.h:124
DTK_DECADE
#define DTK_DECADE
Definition datetime.h:168
DTK_SECOND
#define DTK_SECOND
Definition datetime.h:160
PM
#define PM
Definition datetime.h:72
DTK_NUMBER
#define DTK_NUMBER
Definition datetime.h:141
DTK_STRING
#define DTK_STRING
Definition datetime.h:142
DTERR_INTERVAL_OVERFLOW
#define DTERR_INTERVAL_OVERFLOW
Definition datetime.h:285
DTK_QUARTER
#define DTK_QUARTER
Definition datetime.h:166
DTK_JULIAN
#define DTK_JULIAN
Definition datetime.h:173
MONTH
#define MONTH
Definition datetime.h:91
DHOUR
#define DHOUR
Definition datetime.h:51
DTK_DELTA
#define DTK_DELTA
Definition datetime.h:159
IGNORE_DTF
#define IGNORE_DTF
Definition datetime.h:98
MICROSECOND
#define MICROSECOND
Definition datetime.h:104
DWEEK
#define DWEEK
Definition datetime.h:53
DTK_TZ_HOUR
#define DTK_TZ_HOUR
Definition datetime.h:177
DTK_TIME_M
#define DTK_TIME_M
Definition datetime.h:192
DTK_M
#define DTK_M(t)
Definition datetime.h:187
DTIMEZONE
#define DTIMEZONE
Definition datetime.h:62
HOUR
#define HOUR
Definition datetime.h:100
DTK_TZ_MINUTE
#define DTK_TZ_MINUTE
Definition datetime.h:178
WEEK
#define WEEK
Definition datetime.h:117
DECADE
#define DECADE
Definition datetime.h:118
DAY
#define DAY
Definition datetime.h:93
ADBC
#define ADBC
Definition datetime.h:108
DTK_LATE
#define DTK_LATE
Definition datetime.h:151
YEAR
#define YEAR
Definition datetime.h:92
DTK_DATE
#define DTK_DATE
Definition datetime.h:144
DTK_CENTURY
#define DTK_CENTURY
Definition datetime.h:169
TZ
#define TZ
Definition datetime.h:95
DTK_ISODOW
#define DTK_ISODOW
Definition datetime.h:180
DMONTH
#define DMONTH
Definition datetime.h:54
MILLISECOND
#define MILLISECOND
Definition datetime.h:103
DTERR_BAD_TIMEZONE
#define DTERR_BAD_TIMEZONE
Definition datetime.h:287
DTK_DAY
#define DTK_DAY
Definition datetime.h:163
RESERV
#define RESERV
Definition datetime.h:90
BC
#define BC
Definition datetime.h:76
DB_C
#define DB_C
Definition datetime.h:61
DTERR_BAD_FORMAT
#define DTERR_BAD_FORMAT
Definition datetime.h:282
HR24
#define HR24
Definition datetime.h:73
CENTURY
#define CENTURY
Definition datetime.h:119
DTK_DATE_M
#define DTK_DATE_M
Definition datetime.h:191
DTK_MILLENNIUM
#define DTK_MILLENNIUM
Definition datetime.h:170
TZNAME_ZONE
#define TZNAME_ZONE
Definition datetime.h:301
DTK_EARLY
#define DTK_EARLY
Definition datetime.h:150
DDECADE
#define DDECADE
Definition datetime.h:57
DTK_ISOYEAR
#define DTK_ISOYEAR
Definition datetime.h:179
DDAY
#define DDAY
Definition datetime.h:52
SECOND
#define SECOND
Definition datetime.h:102
DMICROSEC
#define DMICROSEC
Definition datetime.h:47
DTK_ALL_SECS_M
#define DTK_ALL_SECS_M
Definition datetime.h:190
isleap
#define isleap(y)
Definition datetime.h:271
DMILLENNIUM
#define DMILLENNIUM
Definition datetime.h:59
DTZMOD
#define DTZMOD
Definition datetime.h:122
DTK_DOY
#define DTK_DOY
Definition datetime.h:176
DTK_TZ
#define DTK_TZ
Definition datetime.h:146
DOW
#define DOW
Definition datetime.h:106
TZNAME_FIXED_OFFSET
#define TZNAME_FIXED_OFFSET
Definition datetime.h:299
DCENTURY
#define DCENTURY
Definition datetime.h:58
TZNAME_DYNTZ
#define TZNAME_DYNTZ
Definition datetime.h:300
DQUARTER
#define DQUARTER
Definition datetime.h:55
AD
#define AD
Definition datetime.h:75
TOMORROW
#define TOMORROW
Definition datetime.h:43
DTERR_TZDISP_OVERFLOW
#define DTERR_TZDISP_OVERFLOW
Definition datetime.h:286
EARLY
#define EARLY
Definition datetime.h:39
DA_D
#define DA_D
Definition datetime.h:60
ISOTIME
#define ISOTIME
Definition datetime.h:115
DTK_HOUR
#define DTK_HOUR
Definition datetime.h:162
DTK_WEEK
#define DTK_WEEK
Definition datetime.h:164
MINUTE
#define MINUTE
Definition datetime.h:101
DSECOND
#define DSECOND
Definition datetime.h:49
LATE
#define LATE
Definition datetime.h:40
DTK_MICROSEC
#define DTK_MICROSEC
Definition datetime.h:172
DTZ
#define DTZ
Definition datetime.h:96
NOW
#define NOW
Definition datetime.h:41
DMILLISEC
#define DMILLISEC
Definition datetime.h:48
DTK_DOW
#define DTK_DOW
Definition datetime.h:175
DTK_YEAR
#define DTK_YEAR
Definition datetime.h:167
AGO
#define AGO
Definition datetime.h:110
AM
#define AM
Definition datetime.h:71
DTK_MILLISEC
#define DTK_MILLISEC
Definition datetime.h:171
TODAY
#define TODAY
Definition datetime.h:42
YESTERDAY
#define YESTERDAY
Definition datetime.h:44
DTK_MONTH
#define DTK_MONTH
Definition datetime.h:165
DTK_YESTERDAY
#define DTK_YESTERDAY
Definition datetime.h:154
DOY
#define DOY
Definition datetime.h:105
DMINUTE
#define DMINUTE
Definition datetime.h:50
DTERR_FIELD_OVERFLOW
#define DTERR_FIELD_OVERFLOW
Definition datetime.h:283
DTK_ZULU
#define DTK_ZULU
Definition datetime.h:157
TOKMAXLEN
#define TOKMAXLEN
Definition datetime.h:204
DYNTZ
#define DYNTZ
Definition datetime.h:97
DTERR_MD_FIELD_OVERFLOW
#define DTERR_MD_FIELD_OVERFLOW
Definition datetime.h:284
DTK_MINUTE
#define DTK_MINUTE
Definition datetime.h:161
UNITS
#define UNITS
Definition datetime.h:107
DTK_TODAY
#define DTK_TODAY
Definition datetime.h:155
DTK_NOW
#define DTK_NOW
Definition datetime.h:153
val
long val
Definition informix.c:689
value
static struct @174 value
pg_mul_s64_overflow
static bool pg_mul_s64_overflow(int64 a, int64 b, int64 *result)
Definition int.h:293
pg_mul_s32_overflow
static bool pg_mul_s32_overflow(int32 a, int32 b, int32 *result)
Definition int.h:187
pg_add_s64_overflow
static bool pg_add_s64_overflow(int64 a, int64 b, int64 *result)
Definition int.h:235
pg_add_s32_overflow
static bool pg_add_s32_overflow(int32 a, int32 b, int32 *result)
Definition int.h:151
y
int y
Definition isn.c:76
i
int i
Definition isn.c:77
tm
static struct pg_tm tm
Definition localtime.c:104
USE_SQL_DATES
#define USE_SQL_DATES
Definition miscadmin.h:238
USE_POSTGRES_DATES
#define USE_POSTGRES_DATES
Definition miscadmin.h:236
MAXTZLEN
#define MAXTZLEN
Definition miscadmin.h:264
INTSTYLE_SQL_STANDARD
#define INTSTYLE_SQL_STANDARD
Definition miscadmin.h:259
INTSTYLE_POSTGRES_VERBOSE
#define INTSTYLE_POSTGRES_VERBOSE
Definition miscadmin.h:258
USE_ISO_DATES
#define USE_ISO_DATES
Definition miscadmin.h:237
DATEORDER_DMY
#define DATEORDER_DMY
Definition miscadmin.h:244
DATEORDER_YMD
#define DATEORDER_YMD
Definition miscadmin.h:243
INTSTYLE_ISO_8601
#define INTSTYLE_ISO_8601
Definition miscadmin.h:260
USE_XSD_DATES
#define USE_XSD_DATES
Definition miscadmin.h:240
INTSTYLE_POSTGRES
#define INTSTYLE_POSTGRES
Definition miscadmin.h:257
USE_GERMAN_DATES
#define USE_GERMAN_DATES
Definition miscadmin.h:239
exprTypmod
int32 exprTypmod(const Node *expr)
Definition nodeFuncs.c:304
relabel_to_typmod
Node * relabel_to_typmod(Node *expr, int32 typmod)
Definition nodeFuncs.c:694
IsA
#define IsA(nodeptr, _type_)
Definition nodes.h:164
castNode
#define castNode(_type_, nodeptr)
Definition nodes.h:182
pg_ultostr_zeropad
char * pg_ultostr_zeropad(char *str, uint32 value, int32 minwidth)
Definition numutils.c:1266
pg_ultostr
char * pg_ultostr(char *str, uint32 value)
Definition numutils.c:1306
errmsg
static char * errmsg
Definition oauth_hook_client.c:61
MemoryContextSwitchTo
static MemoryContext MemoryContextSwitchTo(MemoryContext context)
Definition palloc.h:124
len
const void size_t len
Definition pg_crc32c_sse42.c:31
list_length
static int list_length(const List *l)
Definition pg_list.h:152
linitial
#define linitial(l)
Definition pg_list.h:178
lsecond
#define lsecond(l)
Definition pg_list.h:183
source
static rewind_source * source
Definition pg_rewind.c:89
scale
static int scale
Definition pgbench.c:182
pg_tzset_offset
pg_tz * pg_tzset_offset(long gmtoffset)
Definition pgtz.c:320
pg_tzenumerate_next
pg_tz * pg_tzenumerate_next(pg_tzenum *dir)
Definition pgtz.c:426
pg_timezone_abbrev_is_known
bool pg_timezone_abbrev_is_known(const char *abbrev, bool *isfixed, long int *gmtoff, int *isdst, const pg_tz *tz)
Definition localtime.c:1862
pg_next_dst_boundary
int pg_next_dst_boundary(const pg_time_t *timep, long int *before_gmtoff, int *before_isdst, pg_time_t *boundary, long int *after_gmtoff, int *after_isdst, const pg_tz *tz)
Definition localtime.c:1611
pg_get_timezone_name
const char * pg_get_timezone_name(pg_tz *tz)
Definition localtime.c:1990
pg_tzset
pg_tz * pg_tzset(const char *tzname)
Definition pgtz.c:234
TZ_STRLEN_MAX
#define TZ_STRLEN_MAX
Definition pgtime.h:54
pg_get_timezone_offset
bool pg_get_timezone_offset(const pg_tz *tz, long int *gmtoff)
Definition localtime.c:1966
pg_get_next_timezone_abbrev
const char * pg_get_next_timezone_abbrev(int *indx, const pg_tz *tz)
Definition localtime.c:1937
session_timezone
PGDLLIMPORT pg_tz * session_timezone
Definition pgtz.c:28
pg_time_t
int64 pg_time_t
Definition pgtime.h:23
pg_tzenumerate_end
void pg_tzenumerate_end(pg_tzenum *dir)
Definition pgtz.c:414
pg_tzenumerate_start
pg_tzenum * pg_tzenumerate_start(void)
Definition pgtz.c:397
pg_interpret_timezone_abbrev
bool pg_interpret_timezone_abbrev(const char *abbrev, const pg_time_t *timep, long int *gmtoff, int *isdst, const pg_tz *tz)
Definition localtime.c:1744
date
long date
Definition pgtypes_date.h:9
sprintf
#define sprintf
Definition port.h:262
pg_toupper
unsigned char pg_toupper(unsigned char ch)
Definition pgstrcasecmp.c:101
pg_tolower
unsigned char pg_tolower(unsigned char ch)
Definition pgstrcasecmp.c:118
strlcpy
size_t strlcpy(char *dst, const char *src, size_t siz)
Definition strlcpy.c:45
BoolGetDatum
static Datum BoolGetDatum(bool X)
Definition postgres.h:112
Datum
uint64_t Datum
Definition postgres.h:70
DatumGetInt32
static int32 DatumGetInt32(Datum X)
Definition postgres.h:202
fb
static int fb(int x)
Definition preproc-init.c:92
range
static struct cvec * range(struct vars *v, chr a, chr b, int cases)
Definition regc_locale.c:412
downcase_truncate_identifier
char * downcase_truncate_identifier(const char *ident, int len, bool warn)
Definition scansup.c:38
strtoint
int strtoint(const char *pg_restrict str, char **pg_restrict endptr, int base)
Definition string.c:50
DateTimeErrorExtra::dtee_timezone
const char * dtee_timezone
Definition datetime.h:293
DateTimeErrorExtra::dtee_abbrev
const char * dtee_abbrev
Definition datetime.h:295
FuncExpr::args
List * args
Definition primnodes.h:801
Node
Definition nodes.h:135
TimeZoneAbbrevTable::abbrevs
datetkn abbrevs[FLEXIBLE_ARRAY_MEMBER]
Definition datetime.h:219
TzAbbrevCache::tz
pg_tz * tz
Definition datetime.c:270
TzAbbrevCache::abbrev
char abbrev[TOKMAXLEN+1]
Definition datetime.c:267
datetkn::token
char token[TOKMAXLEN+1]
Definition datetime.h:209
datetkn::value
int32 value
Definition datetime.h:211
datetkn::type
char type
Definition datetime.h:210
pg_itm_in
Definition timestamp.h:83
pg_itm
Definition timestamp.h:66
pg_tm
Definition pgtime.h:35
pg_tm::tm_hour
int tm_hour
Definition pgtime.h:38
pg_tm::tm_mday
int tm_mday
Definition pgtime.h:39
pg_tm::tm_mon
int tm_mon
Definition pgtime.h:40
pg_tm::tm_min
int tm_min
Definition pgtime.h:37
pg_tm::tm_yday
int tm_yday
Definition pgtime.h:43
pg_tm::tm_wday
int tm_wday
Definition pgtime.h:42
pg_tm::tm_sec
int tm_sec
Definition pgtime.h:36
pg_tm::tm_isdst
int tm_isdst
Definition pgtime.h:44
pg_tm::tm_year
int tm_year
Definition pgtime.h:41
pg_tz
Definition pgtz.h:66
pg_tzenum
Definition pgtz.c:386
tzEntry::abbrev
char * abbrev
Definition tzparser.h:26
zone
Definition zic.c:99
tuplestore_putvalues
void tuplestore_putvalues(Tuplestorestate *state, TupleDesc tdesc, const Datum *values, const bool *isnull)
Definition tuplestore.c:785
INTERVAL_FULL_RANGE
#define INTERVAL_FULL_RANGE
Definition timestamp.h:76
IntervalPGetDatum
static Datum IntervalPGetDatum(const Interval *X)
Definition timestamp.h:58
INTERVAL_MASK
#define INTERVAL_MASK(b)
Definition timestamp.h:73
type
const char * type
Definition wait_event_funcs.c:28
GetCurrentTransactionStartTimestamp
TimestampTz GetCurrentTransactionStartTimestamp(void)
Definition xact.c:872