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