overload 1
span_balance :: (value: Span, largest: Unit) -> (Span, Time_Error)
Balances to largest; calendar conversions require a relative value.
span, error := span_balance(.{ minutes = 90 }, .HOUR);
assert(error.kind == .NONE && span.hours == 1 && span.minutes == 30);overload 2
span_balance :: (
value: Span,
largest: Unit,
relative: Date
) -> (Span, Time_Error)
Uses a relative Date.
span, error := span_balance(.{ days = 40 }, .MONTH, Date.{ 2024, 1, 1 });
assert(error.kind == .NONE && span.months == 1 && span.days == 9);overload 3
span_balance :: (
value: Span,
largest: Unit,
relative: Zoned
) -> (Span, Time_Error)
Uses a relative Zoned.
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);
span, error := span_balance(.{ hours = 30 }, .DAY, start);
assert(error.kind == .NONE && span.days == 1 && span.hours == 7);