std.time
Duration struct
pub struct DurationA distance between two instants, in whole milliseconds. May be negative: a.since(b) with
b later than a says so rather than hiding it.
millis: intThe distance in milliseconds; the sign is the direction.
pub static fn ofMillis(value: int): DurationA duration of whole milliseconds.
pub static fn ofSeconds(value: int): DurationA duration of whole seconds.
pub static fn ofMinutes(value: int): DurationA duration of whole minutes.
pub fn totalMillis(): intThe whole distance in milliseconds.
pub fn totalSeconds(): intThe whole distance in seconds, truncated towards zero.
pub fn plus(other: Duration): DurationThe two added.
pub fn minus(other: Duration): DurationThe other subtracted from this one.
stdlib/std/time.lyr:25
TimeError class
pub class TimeError :: [Throwable]A failed reading of a time text: what was handed in, and what broke.
text: stringWhat went wrong, naming the field that broke.
pub fn message(): stringstdlib/std/time.lyr:66
Instant struct
pub struct InstantA point on the wall clock: milliseconds since 1970-01-01 UTC.
millis: intMilliseconds since the epoch; negative is before 1970.
pub static fn now(): InstantThe wall clock, now.
pub static fn ofEpochMillis(value: int): InstantThe instant at these epoch milliseconds — for stored timestamps and for tests, which want a clock that stands still.
pub fn epochMillis(): intMilliseconds since the epoch — the raw number back, for storing.
pub fn since(earlier: Instant): DurationThe distance from earlier to this instant. Negative when earlier is actually later.
pub fn plus(d: Duration): InstantThis instant moved by a duration; a negative one moves backwards.
pub fn iso(): stringISO 8601 in UTC, millisecond precision: 1970-01-01T00:00:00.000Z.
divFloor/modFloor rather than / and %, so an instant BEFORE the epoch lands in
the right day — truncation would round the day towards 1970 and hand the rest a negative
time.
pub static fn fromIso(text: string): ?InstantReads what iso() writes — the round-trip half that was missing since iso exists:
fromIso(x.iso()) is x, pre-epoch instants included. null when the text is not
that shape or names a day that does not exist; fromIsoOrThrow says which field broke.
Strict on purpose: exactly YYYY-MM-DDTHH:MM:SS.mmmZ, UTC only. A parser that accepts
offsets or shortened forms would be promising calendar arithmetic this module does not
have; the day 31 of February is refused rather than silently carried into March.
pub static fn fromIsoOrThrow(text: string): Instant throws TimeErrorfromIso, with the reason when the text does not read.
stdlib/std/time.lyr:76