NAME

       pmCtime  -  format the date and time for a reporting time­
       zone


C SYNOPSIS

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

       char *pmCtime(const time_t *clock, char *buf)

       cc ... -lpcp


DESCRIPTION

       pmCtime is very similar to ctime(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 ctime(3) the time  to  be  converted  is  passed  via
       clock,  and the result in buf is fixed width fields in the
       format:

                 Fri Sep 13 00:00:00 1986\n\0

       The result buffer buf must be at least 26 bytes long,  and
       no  attempt is made to check this.  pmCtime returns buf as
       the value of the function.

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

       Use pmNewZone(3), pmNewContextZone(3) or  pmUseZone(3)  to
       establish  a  new  current  reporting  timezone  that will
       effect pmCtime but not ctime(3).


SEE ALSO

       ctime(3), PMAPI(3),  pmLocaltime(3),  pmNewContextZone(3),
       pmNewZone(3) and pmUseZone(3).


Man(1) output converted with man2html