{"uid":"cap_nqVRVDutZfHEy3w_09tKz","slug":"timezone-converter-with-dst-handling-1d6f9d81","name":"Timezone Converter with DST Handling","description":"Converts a datetime from one IANA timezone to another with correct DST handling. ISO-8601 input: bare wall-time strings are interpreted in the from_tz, fully-qualified offsets are honored. DST is handled correctly (uses V8's built-in tzdata via Intl.DateTimeFormat). Returns both formatted strings, both UTC offsets, and the difference in hours. Use it for DST-aware time arithmetic, wall-clock to UTC conversion, or converting across cities.","url":"https://x402.agentutility.ai/timezone-convert?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"required":["datetime","from_tz","to_tz"],"properties":{"to_tz":{"type":"string","description":"IANA timezone for the output (e.g. 'Asia/Tokyo')."},"from_tz":{"type":"string","description":"IANA timezone for the input wall-time (e.g. 'America/Los_Angeles')."},"datetime":{"type":"string","description":"ISO-8601 datetime. With offset (e.g. '2026-05-08T12:00:00-07:00') it's used as-is; without offset (e.g. '2026-05-08T12:00:00') it's interpreted in from_tz."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":"object","properties":{"tz":{"type":"string"},"datetime":{"type":"string"},"utc_offset_minutes":{"type":"integer"}}},"from":{"type":"object","properties":{"tz":{"type":"string"},"datetime":{"type":"string"},"utc_offset_minutes":{"type":"integer"}}},"source":{"type":"string"},"utc_iso":{"type":"string"},"utc_offset_diff_hours":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"to":{"tz":"Asia/Tokyo","datetime":"2026-05-09T04:00:00+09:00","utc_offset_minutes":540},"from":{"tz":"America/Los_Angeles","datetime":"2026-05-08T12:00:00-07:00","utc_offset_minutes":-420},"source":"Intl.DateTimeFormat (built-in, IANA tzdata)","utc_iso":"2026-05-08T19:00:00.000Z","utc_offset_diff_hours":16}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4JqxChdxkatQu2ZjhQ_Bz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a datetime from one IANA timezone to another with accurate DST handling, returning formatted times, UTC offsets, and the hour difference.","exampleAgentPrompt":"What time is it in Tokyo when it's 12:00 PM on May 8, 2026 in Los Angeles? Make sure daylight saving time is handled correctly.","exampleUseCases":[{"title":"Global meeting scheduler","prompt":"I need to schedule a call at 3:00 PM on June 15, 2026 in New York — what time will that be in London? I want to make sure DST is accounted for."},{"title":"UTC to local time conversion","prompt":"Convert 2026-07-20T14:30:00Z UTC to Sydney, Australia local time — what's the wall-clock time and what's the offset?"},{"title":"Cross-city time difference check","prompt":"How many hours apart are Chicago and Berlin on March 28, 2026? I want both the local times and the offset difference, with DST handled properly."}],"resultDescription":"Returns a JSON object with: the original datetime and UTC offset for the source timezone, the converted datetime and UTC offset for the target timezone, the raw UTC ISO timestamp, the offset difference in hours, and the data source (IANA tzdata via Intl.DateTimeFormat).","failureModes":["Invalid IANA timezone name returns an error (e.g. 'America/NewYork' instead of 'America/New_York')","Malformed ISO-8601 datetime string causes a parse error","Payment failure via x402 protocol prevents the call from completing","Ambiguous wall-clock times during DST transitions (e.g. clocks falling back) may resolve to one interpretation"],"whenToPreferThis":"Choose this endpoint when you need programmatically reliable, DST-aware timezone conversion using IANA timezone identifiers — especially for scheduling across cities or converting wall-clock times to UTC. Prefer this over client-side JS hacks or libraries that may have stale tzdata, and when you need structured JSON output with both offsets and the hour difference explicitly returned.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:30.674Z","isFirstParty":false,"canonicalSlug":"timezone-converter-with-dst-handling-1d6f9d81"}