{"id":"working-hours-expand","version":"1.0.0","description":"Expand versioned weekly work schedules, overrides, closures, and DST policies into exact UTC intervals.","supported_operations":["expand working hours to UTC","convert weekly shifts to UTC intervals","apply dated schedule overrides","expand split shifts across dates","resolve DST working hours","calculate office schedule UTC","expand closure-aware work calendar"],"unsupported_operations":["parse iCalendar or RRULE","infer statutory holidays","update time-zone data"],"semantics":["Intervals are half-open [start,end), sorted by UTC start then end, and exact duplicates are removed.","Dates use ISO 8601-1:2019 calendar notation; zoned interpretation follows RFC 9557 with explicit gap and overlap policies.","Pinned IANA tzdb 2025b subset only; caller_rule_version identifies caller-supplied rules and is not a claim of current law."],"limits":{"max_input_bytes":200000,"max_days":366,"max_intervals_per_day":16,"max_overrides":366,"max_closures":366,"max_output_intervals":12000},"pricing":{"status":"unpriced","charge_usd":null},"input_schema":{"type":"object","additionalProperties":false,"required":["calendar","range_start_date","range_end_date"],"properties":{"calendar":{"type":"object","additionalProperties":false,"required":["time_zone","caller_rule_version","weekly","overrides","closures","gap_policy","overlap_policy"],"properties":{"time_zone":{"type":"string","minLength":1,"maxLength":64},"caller_rule_version":{"type":"string","minLength":1,"maxLength":100},"weekly":{"type":"object","additionalProperties":false,"properties":{"sun":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"mon":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"tue":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"wed":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"thu":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"fri":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}},"sat":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}}}},"overrides":{"type":"array","maxItems":366,"items":{"type":"object","additionalProperties":false,"required":["date","intervals"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"intervals":{"type":"array","maxItems":16,"items":{"type":"object","additionalProperties":false,"required":["start","end"],"properties":{"start":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},"end":{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$|^24:00$"}}}}}}},"closures":{"type":"array","maxItems":366,"uniqueItems":true,"items":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"gap_policy":{"type":"string","enum":["reject","shift_forward"]},"overlap_policy":{"type":"string","enum":["earlier","later","both"]}}},"range_start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"range_end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}},"output_schema":{"type":"object","additionalProperties":false,"required":["standard_version","data_version","caller_rule_version","canonical_time_zone","intervals"],"properties":{"standard_version":{"type":"string"},"data_version":{"type":"string"},"caller_rule_version":{"type":"string"},"canonical_time_zone":{"type":"string"},"intervals":{"type":"array","maxItems":12000,"items":{"type":"object","additionalProperties":false,"required":["start_epoch_second","end_epoch_second","local_date"],"properties":{"start_epoch_second":{"type":"integer"},"end_epoch_second":{"type":"integer"},"local_date":{"type":"string"}}}}}},"examples":[{"input":{"calendar":{"time_zone":"UTC","caller_rule_version":"example-v1","weekly":{"mon":[{"start":"09:00","end":"17:00"}]},"overrides":[],"closures":[],"gap_policy":"reject","overlap_policy":"earlier"},"range_start_date":"2025-01-06","range_end_date":"2025-01-07"},"output":{"standard_version":"RFC 9557; ISO 8601-1:2019","data_version":"iana-tzdb-2025b","caller_rule_version":"example-v1","canonical_time_zone":"UTC","intervals":[{"start_epoch_second":1736154000,"end_epoch_second":1736182800,"local_date":"2025-01-06"}]}},{"input":{"calendar":{"time_zone":"UTC","caller_rule_version":"example-v1","weekly":{"mon":[{"start":"09:00","end":"17:00"}]},"overrides":[],"closures":["2025-01-06"],"gap_policy":"reject","overlap_policy":"earlier"},"range_start_date":"2025-01-06","range_end_date":"2025-01-07"},"output":{"standard_version":"RFC 9557; ISO 8601-1:2019","data_version":"iana-tzdb-2025b","caller_rule_version":"example-v1","canonical_time_zone":"UTC","intervals":[]}}],"execute_url":"/v1/tools/working-hours-expand/versions/1.0.0/execute"}