---
name: "PQlocalTZInfo"
section: "3"
platform: "linux"
package: "libpqtypes-dev"
version: "1.5.1-9"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/PQlocalTZInfo"
---

# PQlocalTZInfo(3)

Gets the local machine´s timezone information.

## 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)](/pqt-specs/3.md)*