NAME

       pmLocaltime - convert the date and time for a reporting timezone

C SYNOPSIS

       #include <time.h>
       #include <pcp/pmapi.h>

       struct tm *pmLocaltime(const time_t *clock, struct tm *result);

       cc ... -lpcp

DESCRIPTION

       pmLocaltime  is  very  similar  to  localtime(3),  except  the  timezone  used is the current ``reporting
       timezone'' (rather than the default TZ environment variable scheme), and the result is  returned  into  a
       caller-declared buffer (rather than a private buffer).

       Like  localtime(3)  the  time to be converted is passed via clock, and the result contains the components
       broken out in the elements of the tm struct.

       pmLocaltime returns result as the value of the function.

       The default current reporting timezone is as defined by the TZ environment variable, so  pmLocaltime  and
       localtime(3) will initially produce a similar encoding of the date and time.

       Use  pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish a new current reporting timezone that
       will affect pmLocaltime but not localtime(3).

SEE ALSO

       localtime(3), PMAPI(3),  pmCtime(3),  pmGetConfig(3),  pmNewContextZone(3),  pmNewZone(3),  pmUseZone(3),
       pcp.conf(5) and pcp.env(5).