Skip to main content

Module time

Module time 

Source
Expand description

Time through jiff: epoch seconds in everything pitboard stores, the local time zone only in what it shows a person.

There is no free function that reads the clock. Everything that needs to know the time asks its Context, which holds a [Clock]. The expiry of a parked login, whether a renewal is due, and how long doctor says is left are all judgements about time, and none of them could be tested while the clock was a call into the operating system made wherever it was needed.

Functions§

local
epoch in this machine’s time zone, formatted with strftime directives.
moment
What a person reads for a moment: “14:02”, or with the date once it is not today.
parse
An RFC 3339 instant such as 2026-09-20T22:20:00.095287+00:00, as epoch seconds. None for anything else, including a time without an offset, which names no instant.
span
A length of time to the precision a person reads: “6d 4h”, “2h 05m”, “47m”, “<1m”.