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)

libpqtypes                                            2011                                      PQlocalTZInfo(3)