gettzenv(2)                                                 gettzenv(2)

  gettzenv()

  NAME

    gettzenv() - retrieve system timezone information

  SYNOPSIS

    #include 

    char * gettzenv(void)

  DESCRIPTION

    The gettzenv(2) call returns a string describing time zone information in
    the POSIX format. The call returns a pointer to a static buffer containing
    the system time zone, in the form TZ=value. (The exact format is described
    in the man page for tzset(3).)

    If the call cannot retrieve time zone information from the system, the
    call returns NULL.

  RETURN VALUE

    The gettzenv(2) function returns a pointer to a static buffer. On success,
    this buffer contains the environment variable. On failure, the call
    returns NULL.

  SEE ALSO

    tzset(3)

  USAGE NOTES

    The gettzenv function is not thread safe.

    The gettzenv function is not async-signal safe.