NNG_STAT_TIMESTAMP(3)

💖 nng_stat_timestamp — get statistic timestamp 💖

okay bestie, pull up a chair, we're looking at nng_stat_timestamp(3) from the NNG Reference Manual and it's genuinely such a cute little function. no cap. 🦋

---

✨ SYNOPSIS ✨

#include <nng/nng.h>

typedef struct nng_stat nng_stat;

uint64_t nng_stat_timestamp(nng_stat *stat);

like, that's it. that's the whole vibe. 🎀

---

🌸 DESCRIPTION 🌸

so nng_stat_timestamp() hands you back a timestamp, and that timestamp is measured as a number of milliseconds since some arbitrary value in the past. yes, arbitrary. it's not epoch time, it's not your birthday, it's just... some point. we don't ask. 💅

and here's the part that's lowkey important: even within the same snapshot, different statistics might have different timestamp values?? 😭 iconic behaviour actually. that's because the timestamp represents the moment when that particular statistic was captured — not when the whole snapshot got assembled. every stat has main character energy and its own little moment in time. 👑

Tip 💡 these values are intended to facilitate calculation of rates, by comparing values from one snapshot with a subsequent one. so like, snapshot, snapshot again, do a lil subtraction, boom — you've got yourself a rate. math ate. 🔥

Tip 💡 the values used here have the same offset as the nng_clock() supplemental function. super useful when you want to convert these values into local clock time. iykyk. ⭐

---

🌈 RETURN VALUES 🌈

the timestamp when stat was captured, measured as a number of milliseconds since some time in the past. she's giving "vibes-based chronology" and honestly? we respect it. 🫶

---

🎀 ERRORS 🎀

None. literally none. no error states, no sadness, no drama. this function is unbothered, moisturized, in her lane, focused, flourishing. ✨

---

💜 SEE ALSO 💜

• libnng(3)
• nng_stats_get(3)
• nng_stat_value(3)
• nng_clock(3supp)
• nng_stat(5)
• nng(7)

---

and that's the whole page bestie!! 🦋💖 go forth and timestamp responsibly. this was NNG Reference Manual, dated 2026-06-30 — love her, respect her, cite her. mwah. 💅🌸🎀