{"uid":"cap_2M2TOJeTDEVpuqd522Ax0","slug":"current-time-timezone-api-773be3ce","name":"Current Time & Timezone API","description":"Current time, date, and timezone data for AI agents: the clock an LLM does not have. Returns current UTC time and local time for any IANA timezone, abbreviation (EST, JST, CET), or city, with UTC offset, DST state, and the next daylight-saving transition. Also converts timestamps between timezones, does DST-correct date arithmetic and business-day math, and diffs two instants. Unix epoch, ISO 8601, week and quarter. Keyless.","url":"https://api.kadec0.xyz/v1/time","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"to":{"type":"string","description":"target zone(s) for mode=convert"},"tz":{"type":"string","description":"IANA zone, abbreviation (EST/JST), city, or UTC offset; comma list for up to 12 at once"},"add":{"type":"string","description":"duration for mode=add: 3d, -2h30m, 1y2mo, 5bd (business days), or ISO P1DT2H"},"from":{"type":"string","description":"zone a naive `time` is interpreted in (default UTC)"},"mode":{"enum":["now","convert","add","diff"],"type":"string","default":"now","description":"inferred from the other params when omitted"},"time":{"type":"string","description":"ISO 8601, a bare date, or a unix epoch (s/ms); defaults to now"},"to_time":{"type":"string","description":"end instant for mode=diff"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"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_Q8QsuLUYScd1mM8ICFvPV","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current time, date, and timezone data for any IANA timezone, city, or abbreviation, and performs timezone conversion, DST-aware date arithmetic, and timestamp diffing.","exampleAgentPrompt":"What's the current local time in Tokyo, and is daylight saving time active there right now? Also tell me the next DST transition for Asia/Tokyo.","exampleUseCases":[{"title":"Meeting scheduler across timezones","prompt":"It's 3pm in New York on Monday — what time is that in London, Tokyo, and Sydney? I need to find an overlap for a team call."},{"title":"DST-aware deadline calculation","prompt":"Add 10 business days to today's date using the Europe/Berlin timezone — I need the exact date and local time so I can set a contract deadline."},{"title":"Elapsed time between two events","prompt":"How many hours and minutes passed between 2024-03-15T09:00:00 UTC and 2024-03-18T17:30:00 in America/Chicago local time?"}],"resultDescription":"Returns a JSON object with current UTC and local time, UTC offset, DST active flag, next DST transition timestamp, Unix epoch, ISO 8601 formatted datetime, week number, and quarter. For convert mode, returns local times for each target timezone. For add mode, returns the resulting datetime with full timezone context. For diff mode, returns the duration between two instants in multiple units.","failureModes":["Unknown or misspelled timezone returns an error — IANA zone names are case-sensitive","Invalid timestamp format (non-ISO, non-epoch) causes a parsing error","Duration string with unsupported unit (e.g. decades) is rejected","Requesting more than 12 timezones in a single comma-separated list exceeds the limit","Network or upstream downtime returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when an AI agent needs reliable current time data (which LLMs lack natively), timezone conversion, DST awareness, or calendar arithmetic including business-day math. It is keyless and covers all common timezone input formats (IANA, abbreviation, city, UTC offset), making it suitable for scheduling, deadline calculation, meeting coordination, and any agent workflow that depends on accurate time context.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:54.621Z","isFirstParty":false}