Esc

span_compare

procedureextension3 overloadssince 0.36.1Source
  • macOS: span_compare works on macOS
  • Linux: span_compare works on Linux
  • Windows: span_compare works on Windows
  • Wasm: span_compare works on Wasm

overload 1

span_compare :: (a: Span, b: Span) -> (int, Time_Error)

Returns -1/0/1 by elapsed length; calendar units require a shared relative value.

Example↗
order, error := span_compare(.{ hours = 2 }, .{ minutes = 90 });
assert(error.kind == .NONE && order == 1);

overload 2

span_compare :: (a: Span, b: Span, relative: Date) -> (int, Time_Error)

Uses a relative Date.

Example↗
order, error := span_compare(.{ months = 1 }, .{ days = 30 }, Date.{ 2024, 1, 1 });
assert(error.kind == .NONE && order == 1);

overload 3

span_compare :: (a: Span, b: Span, relative: Zoned) -> (int, Time_Error)

Uses a relative Zoned.

Example↗
zone, zone_error := time_zone_from_posix("EST5EDT,M3.2.0,M11.1.0");
assert(zone_error.kind == .NONE);
defer time_zone_free(*zone);
start, _ := to_zoned(.{ .{ 2024, 3, 10 }, .{ 0, 0, 0, 0 } }, zone);
order, error := span_compare(.{ days = 1 }, .{ hours = 24 }, start);
assert(error.kind == .NONE && order == -1);

See also