PQlocalTZInfo(3) libpqtypes Manual PQlocalTZInfo(3)NAMEPQlocalTZInfo - 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 ALSOpqt-specs(3)libpqtypes 2011 PQlocalTZInfo(3)
