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).