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