EMILUA(3em)

💅 EMILUA (3em) 💅

okay so bestie, welcome to Emilua — the Lua execution engine — and today we're doing a lil deep dive on the system clock module ✨ no cap, it's lowkey iconic.

---

🌸 DESCRIPTION 🌸

fr fr, here's the whole vibe in one snippet:

local clock = require('time').system_clock
local timepoint = clock.now()

This is the system-wide real time wall clock 🕰️ — it uses the UNIX epoch, periodt.

⚠️ Note: on most systems, the system time can be adjusted at any moment 😭 like literally whenever, so don't come for me if your clock does a lil cha-cha.

---

✨ FUNCTIONS ✨

• now() → system_clock.time_point — gives you a brand new time point that's the current value of the clock 🫶 she's giving right now energy.
• epoch() → system_clock.time_point — gives you a fresh time point representing the epoch of the clock 💖 the origin story, iykyk.

---

🦋 time_point FUNCTIONS 🦋

• add(self, secs: number) — modifies the time point by the given duration ⏳ slay.

⚠️ Note: when the duration gets converted to the native tick representation of the clock, it'll be rounded to the nearest time point, rounding to even in halfway cases. that rounding-to-even thing is real, bestie, don't sleep on it 💀

• sub(self, secs: number) — modifies the time point by the given duration 💅 same deal.

⚠️ Note: when the duration gets converted to the native tick representation of the clock, it'll be rounded to the nearest time point, rounding to even in halfway cases. yes, same note, she's consistent 👑

---

🎀 time_point PROPERTIES 🎀

• seconds_since_epoch: number — the number of elapsed seconds since 1 January 1970, and it does not count leap seconds 🙈 that's the whole property, no extras.

---

🔥 time_point METAMETHODS 🔥

the girls that get it, get it 🌈 here's the full roster:

• __add()
• __sub()
• __eq()
• __lt()
• __le()

---

and that's the whole page, bestie 🍓 go forth and tell time responsibly 💜

<div align="center">🧚 Emilua 0.12.1-nixpkgs1, dated 1980-01-01 — mwah, kiss kiss, bye bye 🧚</div>