NAME

       PQlocalTZInfo - Gets the local machine´s timezone information.

SYNOPSIS

       #include <libpqtypes.h>

       void PQlocalTZInfo(time_t *t, int *gmtoff, int *isdst, char **tzabbrp);

DESCRIPTION

       This function retrieves the local machine´s timezone information.

       If  the  t  argument is not NULL, it represents a time_t value to get timezone information for.  If it is
       NULL, the current time is used.

       The gmtoff argument will be pointed at the number of seconds from GMT, same  value  as  the  GNU  (struct
       tm).tm_gmtoff extension.

       The  isdst  argument  will  be  pointed  at zero if in standard time, one if in daylight savings time and
       negative one if unknown.

       The tzabbrp argument will be pointed at the timezone abbreviation, like PST, ADT, EST, etc..

RETURN VALUE

       None.

EXAMPLES

       This example gets the local timezone information for a file´s modified time.

              int gmtoff;
              int isdst;
              char *tzabbr;
              struct stat st;

              stat("report.xml", &st);
              PQlocalTZInfo(&st.st_mtime, &gmtoff, &isdst, &tzabbr);

RATIONALE

       libpqtypes needs the ability to get the local machine´s timezone information for the datetime data types.
       It  later  became  apparent  that  a  portable way of getting timezone information was very useful and in
       demand.  Thus, this function was made public.

AUTHOR

       A contribution of eSilo, LLC. for the PostgreSQL Database Management System.  Written by  Andrew  Chernow
       and Merlin Moncure.

REPORTING BUGS

       Report bugs to <libpqtypes@esilo.com>.

COPYRIGHT

       Copyright (c) 2011 eSilo, LLC. All rights reserved.
       This  is  free  software;  see  the  source  for  copying conditions.  There is NO warranty; not even for
       MERCHANTABILITY or  FITNESS FOR A PARTICULAR PURPOSE.

SEE ALSO

       pqt-specs(3)