{"uid":"cap_PwLSOJvxX7aOKBWuk4C4x","slug":"chronosure-business-time-api-d709218b","name":"ChronoSure Business Time API","description":"Resolve a local time to an exact UTC instant with explicit DST ambiguity handling, business-day arithmetic, public-holiday status, and working-hour overlap across timezones. Detects ambiguous and nonexistent local times instead of silently shifting them. Declares its IANA tzdb release and per-jurisdiction holiday provenance.","url":"https://chrono.schemasure.com/v1/business-time?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"instant":{"type":"string","examples":["2026-11-01T05:30:00Z"],"description":"An absolute ISO 8601 instant ending in Z or an explicit offset. Alternative to local_time; send exactly one of the two."},"timezone":{"type":"string","examples":["America/New_York","Pacific/Chatham","Antarctica/Troll"],"minLength":1,"description":"IANA timezone identifier, resolved against tzdb 2026c."},"local_time":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}(:\\d{2})?$","examples":["2026-11-01T01:30:00"],"description":"ISO local date and time with NO offset and no Z suffix. This is the field whose meaning can be ambiguous, which is the point of the endpoint."},"compare_with":{"type":"array","items":{"type":"string"},"examples":[["Europe/London","Asia/Jerusalem"]],"maxItems":5,"description":"Other IANA zones to report the same instant in, and to intersect working hours with."},"working_hours":{"type":"object","required":["start","end"],"properties":{"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"}},"description":"Local business hours, defaulting to 09:00-17:00. end < start means the window crosses midnight.","additionalProperties":false},"ambiguity_policy":{"enum":["earlier","later","compatible","reject"],"type":"string","default":"reject","description":"How to read a local time that occurs twice or not at all. Matches Temporal's disambiguation vocabulary. The default, reject, returns verdict \"unknown\" with both candidate instants rather than silently picking one."},"holiday_calendar":{"enum":["AU-NSW","CA-BC","CA-ON","DE","FR","GB-ENG","GB-NIR","GB-SCT","IE","IL","IN","JP","NL","NZ","US","US-CA","US-NY"],"type":"string","description":"Jurisdiction whose public holidays and weekend definition apply. An unlisted value is rejected with UNSUPPORTED; this service never falls back to an empty holiday list."},"add_business_days":{"type":"integer","maximum":365,"minimum":-365,"description":"Move this many working days from the resolved date, skipping the calendar's weekend days and its public holidays. Zero returns the date unchanged."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8ctNAOGSUvf7pJ2G4cgfp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves local times to UTC instants with explicit DST ambiguity handling, business-day arithmetic, public-holiday detection, and working-hour overlap across multiple timezones.","exampleAgentPrompt":"Can you check whether 2026-11-01T01:30:00 in America/New_York is ambiguous because of the DST fallback, add 5 business days to it using the US holiday calendar, and tell me if that result falls within working hours in both New York and London?","exampleUseCases":[{"title":"DST ambiguity detection for scheduling","prompt":"I need to schedule a meeting at 1:30am on November 1 2026 in America/New_York — can you tell me whether that local time is ambiguous due to the DST clock change, and if so give me both candidate UTC instants rather than picking one silently?"},{"title":"Cross-timezone working hours overlap","prompt":"What UTC window do New York and London share as working hours on 2026-12-15? Use standard 09:00-17:00 local hours for both, and flag if either day is a public holiday under the US or GB-ENG calendars."},{"title":"Business day deadline calculation","prompt":"I need to know what date falls 10 business days after 2026-07-03 in the US-NY holiday calendar — skip weekends and US federal holidays, and tell me the final date in both UTC and America/New_York local time."}],"resultDescription":"Returns the resolved UTC instant, DST verdict (unique, ambiguous, or nonexistent), both candidate instants when ambiguous, per-zone wall-clock representations for any compare_with timezones, public holiday status with holiday name if applicable, whether the instant falls within the specified working hours window, the resulting date after business-day arithmetic, and metadata declaring the IANA tzdb release and holiday data provenance used.","failureModes":["Unsupported holiday_calendar value returns UNSUPPORTED error — no silent fallback to empty calendar","Ambiguous local_time with ambiguity_policy=reject returns verdict 'unknown' with both candidate instants instead of a resolved instant","Nonexistent local_time (gap during spring-forward) returns error or unknown verdict depending on policy","Sending both instant and local_time simultaneously returns a validation error — exactly one must be provided","Invalid IANA timezone identifier returns a rejection with an error message","add_business_days exceeding 365 returns a validation error","Malformed local_time pattern (includes offset or Z suffix) is rejected"],"whenToPreferThis":"Choose this endpoint when your workflow requires reliable, unambiguous datetime resolution that handles DST edge cases explicitly rather than silently shifting times. It is the right choice when you need business-day arithmetic that respects jurisdiction-specific public holidays, when you need to detect whether a local time is ambiguous or nonexistent due to DST transitions, or when you need to find working-hour overlaps across multiple timezones. It is superior to generic datetime libraries or timezone conversion APIs that lack explicit DST ambiguity signaling, verified holiday calendars with declared provenance, and cross-zone working-hour intersection.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:34:31.985Z","isFirstParty":false,"canonicalSlug":"chronosure-business-time-api-d709218b"}