pmlocaltime(3) — Linux manual page

NAME | C SYNOPSIS | DESCRIPTION | SEE ALSO | COLOPHON

PMLOCALTIME(3)           Library Functions Manual          PMLOCALTIME(3)

NAME         top

       pmLocaltime - convert the date and time for a reporting timezone

C SYNOPSIS         top

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

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

       cc ... -lpcp

DESCRIPTION         top

       pmLocaltime  is  very similar to localtime(3), except the timezone
       used is the current ``reporting timezone'' (rather  than  the  de‐
       fault  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 en‐
       vironment 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         top

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

COLOPHON         top

       This  page is part of the PCP (Performance Co-Pilot) project.  In‐
       formation about the project can be found at  ⟨http://www.pcp.io/⟩.
       If  you  have  a  bug  report  for  this  manual  page, send it to
       pcp@groups.io.  This page was obtained from the project's upstream
       Git repository ⟨https://github.com/performancecopilot/pcp.git⟩  on
       2025-08-11.   (At  that  time,  the date of the most recent commit
       that was found in the repository was 2025-08-11.)  If you discover
       any rendering problems in this HTML version of the  page,  or  you
       believe  there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in this
       COLOPHON (which is not part of the original manual page),  send  a
       mail to man-pages@man7.org

Performance Co-Pilot               PCP                     PMLOCALTIME(3)

Pages that refer to this page: pmctime(3)__pmmktime(3)pmnewcontextzone(3)pmnewzone(3)pmtimespec(3)pmtimeval(3)pmusezone(3)pmwhichzone(3)