1 /*-------------------------------------------------------------------------
4 * Timezone Library Integration Functions
6 * Portions Copyright (c) 1996-2006, PostgreSQL Global Development Group
9 * $PostgreSQL: pgsql/src/timezone/pgtz.c,v 1.42 2006/07/14 04:59:30 momjian Exp $
11 *-------------------------------------------------------------------------
13 #define NO_REDEFINE_TIMEFUNCS
21 #include "miscadmin.h"
24 #include "storage/fd.h"
26 #include "utils/datetime.h"
27 #include "utils/elog.h"
28 #include "utils/guc.h"
29 #include "utils/hsearch.h"
31 /* Current global timezone */
32 pg_tz *global_timezone = NULL;
35 static char tzdir[MAXPGPATH];
36 static int done_tzdir = 0;
38 static const char *identify_system_timezone(void);
39 static const char *select_default_timezone(void);
40 static bool set_global_timezone(const char *tzname);
44 * Return full pathname of timezone data directory
52 get_share_path(my_exec_path, tzdir);
53 strcat(tzdir, "/timezone");
61 * The following block of code attempts to determine which timezone in our
62 * timezone database is the best match for the active system timezone.
64 * On most systems, we rely on trying to match the observable behavior of
65 * the C library's localtime() function. The database zone that matches
66 * furthest into the past is the one to use. Often there will be several
67 * zones with identical rankings (since the zic database assigns multiple
68 * names to many zones). We break ties arbitrarily by preferring shorter,
69 * then alphabetically earlier zone names.
71 * Win32's native knowledge about timezones appears to be too incomplete
72 * and too different from the zic database for the above matching strategy
73 * to be of any use. But there is just a limited number of timezones
74 * available, so we can rely on a handmade mapping table instead.
79 #define T_DAY ((time_t) (60*60*24))
80 #define T_WEEK ((time_t) (60*60*24*7))
81 #define T_MONTH ((time_t) (60*60*24*31))
83 #define MAX_TEST_TIMES (52*100) /* 100 years, or 1904..2004 */
88 time_t test_times[MAX_TEST_TIMES];
91 static void scan_available_timezones(char *tzdir, char *tzdirsub,
93 int *bestscore, char *bestzonename);
97 * Get GMT offset from a system struct tm
100 get_timezone_offset(struct tm * tm)
102 #if defined(HAVE_STRUCT_TM_TM_ZONE)
103 return tm->tm_gmtoff;
104 #elif defined(HAVE_INT_TIMEZONE)
105 return -TIMEZONE_GLOBAL;
107 #error No way to determine TZ? Can this happen?
112 * Convenience subroutine to convert y/m/d to time_t (NOT pg_time_t)
115 build_time_t(int year, int month, int day)
119 memset(&tm, 0, sizeof(tm));
121 tm.tm_mon = month - 1;
122 tm.tm_year = year - 1900;
128 * Does a system tm value match one we computed ourselves?
131 compare_tm(struct tm * s, struct pg_tm * p)
133 if (s->tm_sec != p->tm_sec ||
134 s->tm_min != p->tm_min ||
135 s->tm_hour != p->tm_hour ||
136 s->tm_mday != p->tm_mday ||
137 s->tm_mon != p->tm_mon ||
138 s->tm_year != p->tm_year ||
139 s->tm_wday != p->tm_wday ||
140 s->tm_yday != p->tm_yday ||
141 s->tm_isdst != p->tm_isdst)
147 * See how well a specific timezone setting matches the system behavior
149 * We score a timezone setting according to the number of test times it
150 * matches. (The test times are ordered later-to-earlier, but this routine
151 * doesn't actually know that; it just scans until the first non-match.)
153 * We return -1 for a completely unusable setting; this is worse than the
154 * score of zero for a setting that works but matches not even the first
158 score_timezone(const char *tzname, struct tztry * tt)
164 char cbuf[TZ_STRLEN_MAX + 1];
169 * Load timezone directly. Don't use pg_tzset, because we don't want all
170 * timezones loaded in the cache at startup.
172 if (tzload(tzname, &tz.state) != 0)
174 if (tzname[0] == ':' || tzparse(tzname, &tz.state, FALSE) != 0)
176 return -1; /* can't handle the TZ name at all */
180 /* Reject if leap seconds involved */
181 if (!tz_acceptable(&tz))
183 elog(DEBUG4, "Reject TZ \"%s\": uses leap seconds", tzname);
187 /* Check for match at all the test times */
188 for (i = 0; i < tt->n_test_times; i++)
190 pgtt = (pg_time_t) (tt->test_times[i]);
191 pgtm = pg_localtime(&pgtt, &tz);
193 return -1; /* probably shouldn't happen */
194 systm = localtime(&(tt->test_times[i]));
197 elog(DEBUG4, "TZ \"%s\" scores %d: at %ld %04d-%02d-%02d %02d:%02d:%02d %s, system had no data",
198 tzname, i, (long) pgtt,
199 pgtm->tm_year + 1900, pgtm->tm_mon + 1, pgtm->tm_mday,
200 pgtm->tm_hour, pgtm->tm_min, pgtm->tm_sec,
201 pgtm->tm_isdst ? "dst" : "std");
204 if (!compare_tm(systm, pgtm))
206 elog(DEBUG4, "TZ \"%s\" scores %d: at %ld %04d-%02d-%02d %02d:%02d:%02d %s versus %04d-%02d-%02d %02d:%02d:%02d %s",
207 tzname, i, (long) pgtt,
208 pgtm->tm_year + 1900, pgtm->tm_mon + 1, pgtm->tm_mday,
209 pgtm->tm_hour, pgtm->tm_min, pgtm->tm_sec,
210 pgtm->tm_isdst ? "dst" : "std",
211 systm->tm_year + 1900, systm->tm_mon + 1, systm->tm_mday,
212 systm->tm_hour, systm->tm_min, systm->tm_sec,
213 systm->tm_isdst ? "dst" : "std");
216 if (systm->tm_isdst >= 0)
218 /* Check match of zone names, too */
219 if (pgtm->tm_zone == NULL)
220 return -1; /* probably shouldn't happen */
221 memset(cbuf, 0, sizeof(cbuf));
222 strftime(cbuf, sizeof(cbuf) - 1, "%Z", systm); /* zone abbr */
223 if (strcmp(cbuf, pgtm->tm_zone) != 0)
225 elog(DEBUG4, "TZ \"%s\" scores %d: at %ld \"%s\" versus \"%s\"",
226 tzname, i, (long) pgtt,
227 pgtm->tm_zone, cbuf);
233 elog(DEBUG4, "TZ \"%s\" gets max score %d", tzname, i);
239 * Try to identify a timezone name (in our terminology) that best matches the
240 * observed behavior of the system timezone library. We cannot assume that
241 * the system TZ environment setting (if indeed there is one) matches our
242 * terminology, so we ignore it and just look at what localtime() returns.
245 identify_system_timezone(void)
247 static char resultbuf[TZ_STRLEN_MAX + 1];
253 char tmptzdir[MAXPGPATH];
255 char std_zone_name[TZ_STRLEN_MAX + 1],
256 dst_zone_name[TZ_STRLEN_MAX + 1];
257 char cbuf[TZ_STRLEN_MAX + 1];
259 /* Initialize OS timezone library */
263 * Set up the list of dates to be probed to see how well our timezone
264 * matches the system zone. We first probe January and July of 2004; this
265 * serves to quickly eliminate the vast majority of the TZ database
266 * entries. If those dates match, we probe every week from 2004 backwards
267 * to late 1904. (Weekly resolution is good enough to identify DST
268 * transition rules, since everybody switches on Sundays.) The further
269 * back the zone matches, the better we score it. This may seem like a
270 * rather random way of doing things, but experience has shown that
271 * system-supplied timezone definitions are likely to have DST behavior
272 * that is right for the recent past and not so accurate further back.
273 * Scoring in this way allows us to recognize zones that have some
274 * commonality with the zic database, without insisting on exact match.
275 * (Note: we probe Thursdays, not Sundays, to avoid triggering
276 * DST-transition bugs in localtime itself.)
279 tt.test_times[tt.n_test_times++] = build_time_t(2004, 1, 15);
280 tt.test_times[tt.n_test_times++] = t = build_time_t(2004, 7, 15);
281 while (tt.n_test_times < MAX_TEST_TIMES)
284 tt.test_times[tt.n_test_times++] = t;
287 /* Search for the best-matching timezone file */
288 strcpy(tmptzdir, pg_TZDIR());
291 scan_available_timezones(tmptzdir, tmptzdir + strlen(tmptzdir) + 1,
293 &bestscore, resultbuf);
298 * Couldn't find a match in the database, so next we try constructed zone
299 * names (like "PST8PDT").
301 * First we need to determine the names of the local standard and daylight
302 * zones. The idea here is to scan forward from today until we have seen
303 * both zones, if both are in use.
305 memset(std_zone_name, 0, sizeof(std_zone_name));
306 memset(dst_zone_name, 0, sizeof(dst_zone_name));
312 * Round back to a GMT midnight so results don't depend on local time of
315 tnow -= (tnow % T_DAY);
318 * We have to look a little further ahead than one year, in case today is
319 * just past a DST boundary that falls earlier in the year than the next
320 * similar boundary. Arbitrarily scan up to 14 months.
322 for (t = tnow; t <= tnow + T_MONTH * 14; t += T_MONTH)
327 if (tm->tm_isdst < 0)
329 if (tm->tm_isdst == 0 && std_zone_name[0] == '\0')
332 memset(cbuf, 0, sizeof(cbuf));
333 strftime(cbuf, sizeof(cbuf) - 1, "%Z", tm); /* zone abbr */
334 strcpy(std_zone_name, cbuf);
335 std_ofs = get_timezone_offset(tm);
337 if (tm->tm_isdst > 0 && dst_zone_name[0] == '\0')
340 memset(cbuf, 0, sizeof(cbuf));
341 strftime(cbuf, sizeof(cbuf) - 1, "%Z", tm); /* zone abbr */
342 strcpy(dst_zone_name, cbuf);
344 /* Done if found both */
345 if (std_zone_name[0] && dst_zone_name[0])
349 /* We should have found a STD zone name by now... */
350 if (std_zone_name[0] == '\0')
353 (errmsg("unable to determine system timezone, defaulting to \"%s\"", "GMT"),
354 errhint("You can specify the correct timezone in postgresql.conf.")));
355 return NULL; /* go to GMT */
358 /* If we found DST then try STD<ofs>DST */
359 if (dst_zone_name[0] != '\0')
361 snprintf(resultbuf, sizeof(resultbuf), "%s%d%s",
362 std_zone_name, -std_ofs / 3600, dst_zone_name);
363 if (score_timezone(resultbuf, &tt) > 0)
367 /* Try just the STD timezone (works for GMT at least) */
368 strcpy(resultbuf, std_zone_name);
369 if (score_timezone(resultbuf, &tt) > 0)
373 snprintf(resultbuf, sizeof(resultbuf), "%s%d",
374 std_zone_name, -std_ofs / 3600);
375 if (score_timezone(resultbuf, &tt) > 0)
379 * Did not find the timezone. Fallback to use a GMT zone. Note that the
380 * zic timezone database names the GMT-offset zones in POSIX style: plus
381 * is west of Greenwich. It's unfortunate that this is opposite of SQL
382 * conventions. Should we therefore change the names? Probably not...
384 snprintf(resultbuf, sizeof(resultbuf), "Etc/GMT%s%d",
385 (-std_ofs > 0) ? "+" : "", -std_ofs / 3600);
388 (errmsg("could not recognize system timezone, defaulting to \"%s\"",
390 errhint("You can specify the correct timezone in postgresql.conf.")));
395 * Recursively scan the timezone database looking for the best match to
396 * the system timezone behavior.
398 * tzdir points to a buffer of size MAXPGPATH. On entry, it holds the
399 * pathname of a directory containing TZ files. We internally modify it
400 * to hold pathnames of sub-directories and files, but must restore it
401 * to its original contents before exit.
403 * tzdirsub points to the part of tzdir that represents the subfile name
404 * (ie, tzdir + the original directory name length, plus one for the
407 * tt tells about the system timezone behavior we need to match.
409 * *bestscore and *bestzonename on entry hold the best score found so far
410 * and the name of the best zone. We overwrite them if we find a better
411 * score. bestzonename must be a buffer of length TZ_STRLEN_MAX + 1.
414 scan_available_timezones(char *tzdir, char *tzdirsub, struct tztry * tt,
415 int *bestscore, char *bestzonename)
417 int tzdir_orig_len = strlen(tzdir);
419 struct dirent *direntry;
421 dirdesc = AllocateDir(tzdir);
425 (errcode_for_file_access(),
426 errmsg("could not open directory \"%s\": %m", tzdir)));
430 while ((direntry = ReadDir(dirdesc, tzdir)) != NULL)
434 /* Ignore . and .., plus any other "hidden" files */
435 if (direntry->d_name[0] == '.')
438 snprintf(tzdir + tzdir_orig_len, MAXPGPATH - tzdir_orig_len,
439 "/%s", direntry->d_name);
441 if (stat(tzdir, &statbuf) != 0)
444 (errcode_for_file_access(),
445 errmsg("could not stat \"%s\": %m", tzdir)));
446 tzdir[tzdir_orig_len] = '\0';
450 if (S_ISDIR(statbuf.st_mode))
452 /* Recurse into subdirectory */
453 scan_available_timezones(tzdir, tzdirsub, tt,
454 bestscore, bestzonename);
458 /* Load and test this file */
459 int score = score_timezone(tzdirsub, tt);
461 if (score > *bestscore)
464 StrNCpy(bestzonename, tzdirsub, TZ_STRLEN_MAX + 1);
466 else if (score == *bestscore)
468 /* Consider how to break a tie */
469 if (strlen(tzdirsub) < strlen(bestzonename) ||
470 (strlen(tzdirsub) == strlen(bestzonename) &&
471 strcmp(tzdirsub, bestzonename) < 0))
472 StrNCpy(bestzonename, tzdirsub, TZ_STRLEN_MAX + 1);
477 tzdir[tzdir_orig_len] = '\0';
486 const char *stdname; /* Windows name of standard timezone */
487 const char *dstname; /* Windows name of daylight timezone */
488 const char *pgtzname; /* Name of pgsql timezone to map to */
493 * This list was built from the contents of the registry at
494 * HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time
495 * Zones on Windows XP Professional SP1
497 * The zones have been matched to zic timezones by looking at the cities
498 * listed in the win32 display name (in the comment here) in most cases.
501 "Afghanistan Standard Time", "Afghanistan Daylight Time",
503 }, /* (GMT+04:30) Kabul */
505 "Alaskan Standard Time", "Alaskan Daylight Time",
507 }, /* (GMT-09:00) Alaska */
509 "Arab Standard Time", "Arab Daylight Time",
511 }, /* (GMT+03:00) Kuwait, Riyadh */
513 "Arabian Standard Time", "Arabian Daylight Time",
515 }, /* (GMT+04:00) Abu Dhabi, Muscat */
517 "Arabic Standard Time", "Arabic Daylight Time",
519 }, /* (GMT+03:00) Baghdad */
521 "Atlantic Standard Time", "Atlantic Daylight Time",
523 }, /* (GMT-04:00) Atlantic Time (Canada) */
525 "AUS Central Standard Time", "AUS Central Daylight Time",
527 }, /* (GMT+09:30) Darwin */
529 "AUS Eastern Standard Time", "AUS Eastern Daylight Time",
531 }, /* (GMT+10:00) Canberra, Melbourne, Sydney */
533 "Azores Standard Time", "Azores Daylight Time",
535 }, /* (GMT-01:00) Azores */
537 "Canada Central Standard Time", "Canada Central Daylight Time",
538 "Canada/Saskatchewan"
539 }, /* (GMT-06:00) Saskatchewan */
541 "Cape Verde Standard Time", "Cape Verde Daylight Time",
542 "Atlantic/Cape_Verde"
543 }, /* (GMT-01:00) Cape Verde Is. */
545 "Caucasus Standard Time", "Caucasus Daylight Time",
547 }, /* (GMT+04:00) Baku, Tbilisi, Yerevan */
549 "Cen. Australia Standard Time", "Cen. Australia Daylight Time",
551 }, /* (GMT+09:30) Adelaide */
553 "Central America Standard Time", "Central America Daylight Time",
555 }, /* (GMT-06:00) Central America */
557 "Central Asia Standard Time", "Central Asia Daylight Time",
559 }, /* (GMT+06:00) Astana, Dhaka */
561 "Central Europe Standard Time", "Central Europe Daylight Time",
563 }, /* (GMT+01:00) Belgrade, Bratislava, Budapest,
564 * Ljubljana, Prague */
566 "Central European Standard Time", "Central European Daylight Time",
568 }, /* (GMT+01:00) Sarajevo, Skopje, Warsaw,
571 "Central Pacific Standard Time", "Central Pacific Daylight Time",
573 }, /* (GMT+11:00) Magadan, Solomon Is., New
576 "Central Standard Time", "Central Daylight Time",
578 }, /* (GMT-06:00) Central Time (US & Canada) */
580 "China Standard Time", "China Daylight Time",
582 }, /* (GMT+08:00) Beijing, Chongqing, Hong Kong,
585 "Dateline Standard Time", "Dateline Daylight Time",
587 }, /* (GMT-12:00) International Date Line West */
589 "E. Africa Standard Time", "E. Africa Daylight Time",
591 }, /* (GMT+03:00) Nairobi */
593 "E. Australia Standard Time", "E. Australia Daylight Time",
595 }, /* (GMT+10:00) Brisbane */
597 "E. Europe Standard Time", "E. Europe Daylight Time",
599 }, /* (GMT+02:00) Bucharest */
601 "E. South America Standard Time", "E. South America Daylight Time",
603 }, /* (GMT-03:00) Brasilia */
605 "Eastern Standard Time", "Eastern Daylight Time",
607 }, /* (GMT-05:00) Eastern Time (US & Canada) */
609 "Egypt Standard Time", "Egypt Daylight Time",
611 }, /* (GMT+02:00) Cairo */
613 "Ekaterinburg Standard Time", "Ekaterinburg Daylight Time",
615 }, /* (GMT+05:00) Ekaterinburg */
617 "Fiji Standard Time", "Fiji Daylight Time",
619 }, /* (GMT+12:00) Fiji, Kamchatka, Marshall Is. */
621 "FLE Standard Time", "FLE Daylight Time",
623 }, /* (GMT+02:00) Helsinki, Kyiv, Riga, Sofia,
624 * Tallinn, Vilnius */
626 "GMT Standard Time", "GMT Daylight Time",
628 }, /* (GMT) Greenwich Mean Time : Dublin,
629 * Edinburgh, Lisbon, London */
631 "Greenland Standard Time", "Greenland Daylight Time",
633 }, /* (GMT-03:00) Greenland */
635 "Greenwich Standard Time", "Greenwich Daylight Time",
637 }, /* (GMT) Casablanca, Monrovia */
639 "GTB Standard Time", "GTB Daylight Time",
641 }, /* (GMT+02:00) Athens, Istanbul, Minsk */
643 "Hawaiian Standard Time", "Hawaiian Daylight Time",
645 }, /* (GMT-10:00) Hawaii */
647 "India Standard Time", "India Daylight Time",
649 }, /* (GMT+05:30) Chennai, Kolkata, Mumbai, New
652 "Iran Standard Time", "Iran Daylight Time",
654 }, /* (GMT+03:30) Tehran */
656 "Jerusalem Standard Time", "Jerusalem Daylight Time",
658 }, /* (GMT+02:00) Jerusalem */
660 "Korea Standard Time", "Korea Daylight Time",
662 }, /* (GMT+09:00) Seoul */
664 "Mexico Standard Time", "Mexico Daylight Time",
665 "America/Mexico_City"
666 }, /* (GMT-06:00) Guadalajara, Mexico City,
669 "Mexico Standard Time", "Mexico Daylight Time",
671 }, /* (GMT-07:00) Chihuahua, La Paz, Mazatlan */
673 "Mid-Atlantic Standard Time", "Mid-Atlantic Daylight Time",
674 "Atlantic/South_Georgia"
675 }, /* (GMT-02:00) Mid-Atlantic */
677 "Mountain Standard Time", "Mountain Daylight Time",
679 }, /* (GMT-07:00) Mountain Time (US & Canada) */
681 "Myanmar Standard Time", "Myanmar Daylight Time",
683 }, /* (GMT+06:30) Rangoon */
685 "N. Central Asia Standard Time", "N. Central Asia Daylight Time",
687 }, /* (GMT+06:00) Almaty, Novosibirsk */
689 "Nepal Standard Time", "Nepal Daylight Time",
691 }, /* (GMT+05:45) Kathmandu */
693 "New Zealand Standard Time", "New Zealand Daylight Time",
695 }, /* (GMT+12:00) Auckland, Wellington */
697 "Newfoundland Standard Time", "Newfoundland Daylight Time",
698 "Canada/Newfoundland"
699 }, /* (GMT-03:30) Newfoundland */
701 "North Asia East Standard Time", "North Asia East Daylight Time",
703 }, /* (GMT+08:00) Irkutsk, Ulaan Bataar */
705 "North Asia Standard Time", "North Asia Daylight Time",
707 }, /* (GMT+07:00) Krasnoyarsk */
709 "Pacific SA Standard Time", "Pacific SA Daylight Time",
711 }, /* (GMT-04:00) Santiago */
713 "Pacific Standard Time", "Pacific Daylight Time",
715 }, /* (GMT-08:00) Pacific Time (US & Canada);
718 "Romance Standard Time", "Romance Daylight Time",
720 }, /* (GMT+01:00) Brussels, Copenhagen, Madrid,
723 "Russian Standard Time", "Russian Daylight Time",
725 }, /* (GMT+03:00) Moscow, St. Petersburg,
728 "SA Eastern Standard Time", "SA Eastern Daylight Time",
729 "America/Buenos_Aires"
730 }, /* (GMT-03:00) Buenos Aires, Georgetown */
732 "SA Pacific Standard Time", "SA Pacific Daylight Time",
734 }, /* (GMT-05:00) Bogota, Lima, Quito */
736 "SA Western Standard Time", "SA Western Daylight Time",
738 }, /* (GMT-04:00) Caracas, La Paz */
740 "Samoa Standard Time", "Samoa Daylight Time",
742 }, /* (GMT-11:00) Midway Island, Samoa */
744 "SE Asia Standard Time", "SE Asia Daylight Time",
746 }, /* (GMT+07:00) Bangkok, Hanoi, Jakarta */
748 "Malay Peninsula Standard Time", "Malay Peninsula Daylight Time",
750 }, /* (GMT+08:00) Kuala Lumpur, Singapore */
752 "South Africa Standard Time", "South Africa Daylight Time",
754 }, /* (GMT+02:00) Harare, Pretoria */
756 "Sri Lanka Standard Time", "Sri Lanka Daylight Time",
758 }, /* (GMT+06:00) Sri Jayawardenepura */
760 "Taipei Standard Time", "Taipei Daylight Time",
762 }, /* (GMT+08:00) Taipei */
764 "Tasmania Standard Time", "Tasmania Daylight Time",
766 }, /* (GMT+10:00) Hobart */
768 "Tokyo Standard Time", "Tokyo Daylight Time",
770 }, /* (GMT+09:00) Osaka, Sapporo, Tokyo */
772 "Tonga Standard Time", "Tonga Daylight Time",
774 }, /* (GMT+13:00) Nuku'alofa */
776 "US Eastern Standard Time", "US Eastern Daylight Time",
778 }, /* (GMT-05:00) Indiana (East) */
780 "US Mountain Standard Time", "US Mountain Daylight Time",
782 }, /* (GMT-07:00) Arizona */
784 "Vladivostok Standard Time", "Vladivostok Daylight Time",
786 }, /* (GMT+10:00) Vladivostok */
788 "W. Australia Standard Time", "W. Australia Daylight Time",
790 }, /* (GMT+08:00) Perth */
791 /* {"W. Central Africa Standard Time", "W. Central Africa Daylight Time",
792 * * * * ""}, Could not find a match for this one. Excluded for now. *//* (
793 * G MT+01:00) West Central Africa */
795 "W. Europe Standard Time", "W. Europe Daylight Time",
797 }, /* (GMT+01:00) Amsterdam, Berlin, Bern, Rome,
798 * Stockholm, Vienna */
800 "West Asia Standard Time", "West Asia Daylight Time",
802 }, /* (GMT+05:00) Islamabad, Karachi, Tashkent */
804 "West Pacific Standard Time", "West Pacific Daylight Time",
806 }, /* (GMT+10:00) Guam, Port Moresby */
808 "Yakutsk Standard Time", "Yakutsk Daylight Time",
810 }, /* (GMT+09:00) Yakutsk */
817 identify_system_timezone(void)
821 char localtzname[256];
822 time_t t = time(NULL);
823 struct tm *tm = localtime(&t);
830 (errmsg_internal("could not determine current date/time: localtime failed")));
834 memset(tzname, 0, sizeof(tzname));
835 strftime(tzname, sizeof(tzname) - 1, "%Z", tm);
837 for (i = 0; win32_tzmap[i].stdname != NULL; i++)
839 if (strcmp(tzname, win32_tzmap[i].stdname) == 0 ||
840 strcmp(tzname, win32_tzmap[i].dstname) == 0)
842 elog(DEBUG4, "TZ \"%s\" matches Windows timezone \"%s\"",
843 win32_tzmap[i].pgtzname, tzname);
844 return win32_tzmap[i].pgtzname;
849 * Localized Windows versions return localized names for the timezone.
850 * Scan the registry to find the English name, and then try matching
851 * against our table again.
853 memset(localtzname, 0, sizeof(localtzname));
854 if (RegOpenKeyEx(HKEY_LOCAL_MACHINE,
855 "SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Time Zones",
858 &rootKey) != ERROR_SUCCESS)
861 (errmsg_internal("could not open registry key to identify Windows timezone: %i", (int) GetLastError())));
865 for (idx = 0;; idx++)
874 memset(keyname, 0, sizeof(keyname));
875 namesize = sizeof(keyname);
876 if ((r = RegEnumKeyEx(rootKey,
883 &lastwrite)) != ERROR_SUCCESS)
885 if (r == ERROR_NO_MORE_ITEMS)
888 (errmsg_internal("could not enumerate registry subkeys to identify Windows timezone: %i", (int) r)));
892 if ((r = RegOpenKeyEx(rootKey, keyname, 0, KEY_READ, &key)) != ERROR_SUCCESS)
895 (errmsg_internal("could not open registry subkey to identify Windows timezone: %i", (int) r)));
899 memset(zonename, 0, sizeof(zonename));
900 namesize = sizeof(zonename);
901 if ((r = RegQueryValueEx(key, "Std", NULL, NULL, zonename, &namesize)) != ERROR_SUCCESS)
904 (errmsg_internal("could not query value for 'std' to identify Windows timezone: %i", (int) r)));
908 if (strcmp(tzname, zonename) == 0)
911 strcpy(localtzname, keyname);
915 memset(zonename, 0, sizeof(zonename));
916 namesize = sizeof(zonename);
917 if ((r = RegQueryValueEx(key, "Dlt", NULL, NULL, zonename, &namesize)) != ERROR_SUCCESS)
920 (errmsg_internal("could not query value for 'dlt' to identify Windows timezone: %i", (int) r)));
924 if (strcmp(tzname, zonename) == 0)
926 /* Matched DST zone */
927 strcpy(localtzname, keyname);
935 RegCloseKey(rootKey);
939 /* Found a localized name, so scan for that one too */
940 for (i = 0; win32_tzmap[i].stdname != NULL; i++)
942 if (strcmp(localtzname, win32_tzmap[i].stdname) == 0 ||
943 strcmp(localtzname, win32_tzmap[i].dstname) == 0)
945 elog(DEBUG4, "TZ \"%s\" matches localized Windows timezone \"%s\" (\"%s\")",
946 win32_tzmap[i].pgtzname, tzname, localtzname);
947 return win32_tzmap[i].pgtzname;
953 (errmsg("could not find a match for Windows timezone \"%s\"",
962 * We keep loaded timezones in a hashtable so we don't have to
963 * load and parse the TZ definition file every time it is selected.
965 static HTAB *timezone_cache = NULL;
968 init_timezone_hashtable(void)
972 MemSet(&hash_ctl, 0, sizeof(hash_ctl));
974 hash_ctl.keysize = TZ_STRLEN_MAX + 1;
975 hash_ctl.entrysize = sizeof(pg_tz);
977 timezone_cache = hash_create("Timezones",
988 * Load a timezone from file or from cache.
989 * Does not verify that the timezone is acceptable!
992 pg_tzset(const char *name)
997 if (strlen(name) > TZ_STRLEN_MAX)
998 return NULL; /* not going to fit */
1000 if (!timezone_cache)
1001 if (!init_timezone_hashtable())
1004 tzp = (pg_tz *) hash_search(timezone_cache,
1010 /* Timezone found in cache, nothing more to do */
1014 if (tzload(name, &tz.state) != 0)
1016 if (name[0] == ':' || tzparse(name, &tz.state, FALSE) != 0)
1018 /* Unknown timezone. Fail our call instead of loading GMT! */
1023 strcpy(tz.TZname, name);
1025 /* Save timezone in the cache */
1026 tzp = hash_search(timezone_cache,
1031 strcpy(tzp->TZname, tz.TZname);
1032 memcpy(&tzp->state, &tz.state, sizeof(tz.state));
1039 * Check whether timezone is acceptable.
1041 * What we are doing here is checking for leap-second-aware timekeeping.
1042 * We need to reject such TZ settings because they'll wreak havoc with our
1043 * date/time arithmetic.
1045 * NB: this must NOT ereport(ERROR). The caller must get control back so that
1046 * it can restore the old value of TZ if we don't like the new one.
1049 tz_acceptable(pg_tz *tz)
1055 * To detect leap-second timekeeping, run pg_localtime for what should be
1056 * GMT midnight, 2000-01-01. Insist that the tm_sec value be zero; any
1057 * other result has to be due to leap seconds.
1059 time2000 = (POSTGRES_EPOCH_JDATE - UNIX_EPOCH_JDATE) * SECS_PER_DAY;
1060 tt = pg_localtime(&time2000, tz);
1061 if (!tt || tt->tm_sec != 0)
1069 * Set the global timezone. Verify that it's acceptable first.
1072 set_global_timezone(const char *tzname)
1076 if (!tzname || !tzname[0])
1079 tznew = pg_tzset(tzname);
1083 if (!tz_acceptable(tznew))
1086 global_timezone = tznew;
1091 * Identify a suitable default timezone setting based on the environment,
1092 * and make it active.
1094 * We first look to the TZ environment variable. If not found or not
1095 * recognized by our own code, we see if we can identify the timezone
1096 * from the behavior of the system timezone library. When all else fails,
1100 select_default_timezone(void)
1104 def_tz = getenv("TZ");
1105 if (set_global_timezone(def_tz))
1108 def_tz = identify_system_timezone();
1109 if (set_global_timezone(def_tz))
1112 if (set_global_timezone("GMT"))
1116 (errmsg("could not select a suitable default timezone"),
1117 errdetail("It appears that your GMT time zone uses leap seconds. PostgreSQL does not support leap seconds.")));
1118 return NULL; /* keep compiler quiet */
1122 * Initialize timezone library
1124 * This is called after initial loading of postgresql.conf. If no TimeZone
1125 * setting was found therein, we try to derive one from the environment.
1128 pg_timezone_initialize(void)
1130 /* Do we need to try to figure the timezone? */
1131 if (pg_strcasecmp(GetConfigOption("timezone"), "UNKNOWN") == 0)
1135 /* Select setting */
1136 def_tz = select_default_timezone();
1137 /* Tell GUC about the value. Will redundantly call pg_tzset() */
1138 SetConfigOption("timezone", def_tz, PGC_POSTMASTER, PGC_S_ARGV);