{"uid":"cap_sk_nDyM5WF7HW8V2NVbo1","slug":"fittings-timezone-offset-lookup-3550ecce","name":"fittings Timezone Offset Lookup","description":"The UTC offset, abbreviation and DST state a zone was on at any moment from 1970, with the surrounding transitions, and resolution of ambiguous or nonexistent local times.","url":"https://fittings.sh/v1/tz/offset-at","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":["timezone"],"properties":{"instant":{"type":"string","description":"ISO 8601 with an explicit Z or +HH:MM offset. Give this or localTime."},"timezone":{"type":"string","description":"IANA zone, e.g. America/New_York"},"localTime":{"type":"string","description":"Wall-clock time with no offset, e.g. 2026-11-01T01:30:00. Give this or instant."}}}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LCVwa6fT82JvbRNsa5rNq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the UTC offset, timezone abbreviation, and DST state for an IANA timezone at a specific moment, including surrounding DST transitions and resolution of ambiguous or nonexistent local times.","exampleAgentPrompt":"What UTC offset and timezone abbreviation was America/New_York using on 2024-03-10T07:00:00Z — was it on DST, and what were the surrounding transition times?","exampleUseCases":[{"title":"Scheduling across DST boundary","prompt":"I'm scheduling a meeting for 2026-11-01T01:30:00 in America/Chicago — that's a fall-back ambiguous hour. Can you resolve which UTC instant that maps to and tell me the UTC offset in effect?"},{"title":"Historical UTC offset lookup","prompt":"What UTC offset and abbreviation was Australia/Lord_Howe_Island using on 1998-09-15T12:00:00Z? I need to know if DST was active at that moment."},{"title":"Validating a logged timestamp","prompt":"I have a log entry timestamped 2025-03-30T01:30:00 in Europe/London — is that a nonexistent time due to the spring-forward, and what's the nearest valid UTC equivalent?"}],"resultDescription":"Returns the UTC offset in seconds or hours, the timezone abbreviation (e.g. EST, CEST), whether DST was active, the start and end instants of the surrounding DST transitions, and resolution details for ambiguous or nonexistent local times.","failureModes":["Invalid or unknown IANA timezone name returns an error","Malformed ISO 8601 instant string returns a parse error","Providing neither instant nor localTime returns a validation error","Providing both instant and localTime simultaneously may return an error or prefer one over the other","Instants before 1970 may not be supported or may return limited data"],"whenToPreferThis":"Use this endpoint when you need precise UTC offset, DST state, or timezone abbreviation for a specific IANA zone at an exact historical or future moment — especially when handling ambiguous fall-back or nonexistent spring-forward local times. Prefer this over simple offset tables or language-library lookups when accuracy around DST transitions is critical or when you need the surrounding transition boundaries explicitly returned.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:23.351Z","isFirstParty":false}