PMLOCALTIME(3)

💖 PMLOCALTIME(3) 💖

okay bestie, welcome to the Library Functions Manual corner of the PCP-verse ✨ this one's short, sweet, and honestly kind of iconic.

---

🌸 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 🦋

so pmLocaltime is basically localtime(3)'s cooler cousin 💅 it does the same lil job, but there are two major glow-ups:

• the timezone it uses is the current "reporting timezone", not the default TZ environment variable scheme, and
• the result gets written into a buffer you declare, not some private buffer it keeps to itself 🙈

like localtime(3), the time you wanna convert gets passed in through clock, and the result you get back has all the components broken out into the elements of the tm struct 🎀

pmLocaltime returns result as the value of the function. periodt.

the default current reporting timezone is whatever the TZ environment variable defines, so at first pmLocaltime and localtime(3) will produce a similar encoding of the date and time. twin behavior, no cap 🌈

now for the main character move: use pmNewZone(3), pmNewContextZone(3) or pmUseZone(3) to establish a new current reporting timezone. that new zone 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)
• pcp.env(5)

---

and that's the whole page, bestie, you ate it 🍓 this was Performance Co-Pilot (aka PCP) dropping PMLOCALTIME(3) — go forth and convert your timestamps responsibly, mwah 💜🎀