notesy::time

The time: now, written in the user's time zone, read from a date, and how long ago something was. Needs nothing.

rustuse notesy::{log, store, time};

pub fn ready() {
    let now = time::now();
    log::info(`It's ${time::format(now, "%H:%M")}`);
    if let Some(at) = store::get("synced") {
        log::info(`Synced ${time::ago(at)}`);
    }
    store::set("synced", now);
    let due = time::parse("2026-09-30").unwrap_or(0);
    log::info(`${(due - now) / 86400} days to go`);
}
Function What it does
time::now() Seconds since 1 January 1970 (UTC), now.
time::format(secs, pattern) secs written in the user's time zone with a strftime pattern: %Y-%m-%d, %H:%M, %a for the day's short name … An empty or broken pattern writes it as ISO 8601, in UTC.
time::parse(text) Seconds for a date as front matter writes one: 2026-09-14, maybe with a time (2026-09-14T15:00, :30 for seconds) and a Z or +01:00. Without an offset it counts as UTC, so a date's day and hour read back with plain arithmetic (secs % 86400 / 3600 is its hour). None for text that isn't a date.
time::ago(secs) How long ago that was, as notesy says it: just now, 5 minutes ago, yesterday, 3 days ago, then the date.
time::after(seconds, handler) handler() once, seconds from now (a fraction is fine). Its id, a number, for time::cancel.
time::every(seconds, handler) handler() every seconds, at most once a second, until it's cancelled or the plugin stops. A computer that slept doesn't owe it the times it missed: the next is from when it woke. Its id.
time::cancel(id) Lets go of a timer; one that's gone already is nothing to cancel.

A script has at most 32 timers waiting. Its handlers run between everything else it's handed, one at a time, each within the budget of a call; one that fails counts as a failure, as an event handler's does.

Every page