Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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 de-
       mand.  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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLES | RATIONALE | AUTHOR | REPORTING BUGS | COPYRIGHT | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=PQlocalTZInfo&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help