libpqtypes home page

PQlocalTZInfo(3)               libpqtypes Manual              PQlocalTZInfo(3)



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 infor-
       mation 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)

libpqtypes home page