taia_now(3)

💖 NAME 💖

taia_now — bestie, this one grabs you the current time. Like, right now. Clock in, queen. ⏰✨

🎀 SYNTAX 🎀

#include <libowfat/taia.h>

extern int taia_now(struct taia* t);

That's it. That's the whole vibe. One header, one function, one pointer. 💅

🌸 DESCRIPTION 🌸

taia_now... no wait, taia_now puts the current time into t. But fr fr, let's be precise, because we are precise girlies here:

More precisely — and yes the original page literally says tai_now here, not taia_now, and we are not fixing it because facts are facts, bestie 🫶 — tai_now puts into t its best guess as to the TAI64NA label for the 1-attosecond interval that contains the current time.

One attosecond. That's 1/1,000,000,000,000,000,000 of a second. She's ambitious and we respect that. 😭💀

This implementation of taia_now assumes that the time_t returned from the time function represents the number of TAI seconds since 1970-01-01 00:00:10 TAI. And the way that this matches up is with the convention used by the Olson tz library in "right" mode. Iykyk. 🌈

⚠️ BEWARE, BESTIE. Many clocks are not set accurately. And even the best scientific clocks are nowhere near 1-attosecond accuracy. So no, this is not the crown jewel of precision. 😭👑

BUT. Here's the slay: an inaccurate clock may still produce reasonably accurate time differences. So if you're measuring how long something took rather than what time it is, you're still eating. 🔥

🦋 SEE ALSO 🦋

• tai_now(3) — her sister, the icon herself. 👑

Okay so this page came from the Library Functions Manual, section 3, page taia_now(3), and ngl there's no date stamped on this one — it just shows up with the same taia_now(3) footer it started with. Love that for her. No notes. Periodt. 💖✨🎀