hive-ttracking.clock — io.github.hive-agi/hive-ttracking 0.1.4

Clock facade for domain code.

Domain layers MUST NOT call java.time.* or System/currentTimeMillis directly — route through this ns so tests can pin time without with-redefs on JVM statics.

Substitution model: java.time.Clock rebinding via *clock*.

• Default: Clock/systemDefaultZone
• Tests: bind to Clock/fixed for deterministic instants
• All now-* fns honor the dynamic binding

Provided primitives mirror the subset needed by hive-knowledge, hive-mcp, and other consumers. Add new fns here, never inline java.time.* in calling code.

*clock* clj

Clock used by all now-* fns. Rebind to Clock/fixed in tests.

between clj

(between unit-kw a b)

Whole units of unit-kw between two Temporals. unit-kw ∈ #{:nanos :micros :millis :seconds :minutes :hours :days :weeks :months :years}.

between-days clj

(between-days a b)

between-hours clj

(between-hours a b)

between-millis clj

(between-millis a b)

between-minutes clj

(between-minutes a b)

format-temporal clj

(format-temporal t pattern)

Format a java.time.temporal.Temporal with the given pattern.

now-instant clj

(now-instant)

now-local-date clj

(now-local-date)

now-local-date-time clj

(now-local-date-time)

now-millis clj

(now-millis)

now-zoned-date-time clj

(now-zoned-date-time)

parse-instant clj

(parse-instant s)

Parse an ISO-8601 instant string.

parse-local-date-time clj

(parse-local-date-time s)

Parse an ISO-8601 local datetime string.

parse-zoned-date-time clj

(parse-zoned-date-time s)

Parse an ISO-8601 zoned datetime string.

today-yyyy-mm-dd clj

(today-yyyy-mm-dd)

Convenience: today's date as yyyy-MM-dd honoring *clock*.

with-clock clj macro

(with-clock clock & body)

Run body with *clock* bound to the given java.time.Clock.

with-fixed clj macro

(with-fixed instant & body)

Run body with *clock* pinned at instant in the system default zone. For an explicit zone, use with-fixed-in-zone.

Why split: Clojure forbids two variadic overloads on a single fn/macro (the original two-arity defmacro fails to compile with 'Can't have more than 1 variadic overload'). Splitting into two macros gives both call sites a usable surface.

with-fixed-in-zone clj macro

(with-fixed-in-zone instant zone & body)

Run body with *clock* pinned at instant in the given zone.