NAME

       pmCtime - format the date and time for a reporting timezone

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