{"uid":"cap_s49DvSdAjJOYgqj4EHit7","slug":"402utils-timezone-converter-907a7cd1","name":"402utils Timezone Converter","description":"Convert a datetime between any two IANA time zones using the runtime's ICU tzdb — always current, DST-correct, half-hour zones included. A datetime without offset is read as wall time in `from` (ambiguous fall-back times resolve to the earlier instant; times skipped by spring-forward shift ahead, flagged in `note`). Returns both ISO datetimes with offsets and DST status per side. Unknown zone → 400 with a spelling suggestion.","url":"https://402utils.com/v1/timezone-convert","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","description":"Target IANA zone, e.g. Asia/Ho_Chi_Minh."},"from":{"type":"string","description":"Source IANA zone, e.g. Europe/Paris."},"datetime":{"type":"string","description":"ISO 8601. With Z/±HH:MM it is an absolute instant; without, wall time in `from`."}},"description":"Query params. `datetime` optional (default: now). `from`/`to` are IANA zone ids."}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["input","output","fromOffset","toOffset","dstActive"],"properties":{"note":{"type":"string","description":"Present when the wall time was ambiguous or nonexistent in `from`."},"input":{"type":"string","description":"The instant expressed in `from`, ISO with offset."},"output":{"type":"string","description":"The same instant expressed in `to`."},"toOffset":{"type":"string","description":"UTC offset of `to` at that instant."},"dstActive":{"type":"object","required":["from","to"],"properties":{"to":{"type":"boolean"},"from":{"type":"boolean"}},"description":"Whether daylight-saving time is in effect on each side."},"fromOffset":{"type":"string","description":"UTC offset of `from` at that instant, ±HH:MM."}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"input":"2026-07-14T09:30:00+02:00","output":"2026-07-14T14:30:00+07:00","toOffset":"+07:00","dstActive":{"to":false,"from":true},"fromOffset":"+02:00"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n4qwyD7ABUIQd6pI36eyX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a datetime from one IANA time zone to another, returning ISO datetimes with offsets, UTC offsets, and DST status for both sides.","exampleAgentPrompt":"What time does a meeting at 2025-09-15T09:30:00 in America/New_York land in Asia/Kolkata — and is DST active on either side?","exampleUseCases":[{"title":"Convert meeting time across continents","prompt":"I need to schedule a call for 2025-11-03T14:00:00 in Europe/London — what time will that be in Australia/Sydney, and is daylight saving active in either city?"},{"title":"Handle spring-forward gap conversion","prompt":"What's the equivalent of 2025-03-09T02:30:00 in America/Chicago converted to UTC? I want to make sure you handle the spring-forward gap correctly and let me know if that wall time even exists."},{"title":"Check DST status for half-hour zone","prompt":"Can you convert 2025-07-20T08:00:00 from America/Los_Angeles to Asia/Kathmandu and tell me the UTC offsets and whether DST is in effect on both sides?"}],"resultDescription":"Returns a JSON object with: the original datetime expressed in the source zone (ISO with offset), the equivalent datetime in the target zone (ISO with offset), the UTC offsets for both sides, boolean DST status for each zone, and optionally a note if the input wall time was ambiguous (fall-back) or nonexistent (spring-forward).","failureModes":["Unknown IANA zone name → 400 with a spelling suggestion for the closest match","Missing required 'from' or 'to' query params → 400 validation error","Malformed ISO 8601 datetime string → 400 parse error","Network timeout → connection error"],"whenToPreferThis":"Use this endpoint when you need DST-correct, authoritative timezone conversion backed by the ICU tzdb — especially for edge cases like half-hour zones (e.g. Asia/Kolkata, Asia/Kathmandu), ambiguous fall-back times, or spring-forward gaps. Prefer this over manual UTC offset arithmetic, which breaks around DST transitions and for non-standard offsets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:54:04.283Z","isFirstParty":false}