The type for non-negative monotonic time spans.

They represent the difference between two monotonic clock readings with nanosecond precision (1e-9s) and can measure up to approximatevely 584 Julian year spans before silently rolling over (unlikely since this is in a single program run).

zero is a span of 0ns.

one is a span of 1ns.

max_span is a span of 2^64-1ns.

add s0 s1 is s0 + s1. Warning. Rolls over on overflow.

abs_diff s0 s1 is the absolute difference between s0 and s1.

equal s0 s1 is s0 = s1.

compare s0 s1 orders span by increasing duration.

is_shorter span ~than is true iff span lasts less than than.

is_longer span ~than is true iff span lasts more than than.

n * dur is n times duration n. Does not check for overflow or that n is positive.

ns is a nanosecond duration, 1·10^-9s.

us is a microsecond duration, 1·10^-6s.

ms is a millisecond duration, 1·10^-3s.

s is a second duration, 1s.

min is a minute duration, 60s.

hour is an hour duration, 3600s.

day is a day duration, 86'400s.

year is a Julian year duration (365.25 days), 31'557'600s.

to_uint64_ns s is s as an unsigned 64-bit integer nanosecond span.

of_uint64_ns u is the unsigned 64-bit integer nanosecond span u as a span.

of_float_ns f is the positive floating point nanosecond span f as a span. This is None if f is negative, non finite, or larger or equal than 2⁵³ (~104 days, the largest exact floating point integer).

to_float_ns s is span as a nanosecond floating point span. Note that if s is larger than 2⁵³ (~104 days, the largest exact floating point integer) the result is an approximation and will not round trip with of_float_ns.

pp formats with Fmt.uint64_ns_span.

pp_ns ppf s prints s as an unsigned 64-bit integer nanosecond span.