{"uid":"cap_tjIxC23_1oJcmWtgNd3s1","slug":"x402-tools-timezone-math-b871de78","name":"x402-tools Timezone Math","description":"Pay-per-call utility APIs for AI agents, settled in USDC via the x402 protocol.","url":"https://x402.nichospt.net/timezone-math?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"to":{"type":"string","description":"Target IANA timezone (required)"},"from":{"type":"string","description":"Source IANA timezone (e.g. 'America/Los_Angeles')"},"query":{"type":"string","description":"Natural language form (e.g. '3pm PT next Thursday in IST'). Mutually exclusive with datetime+from."},"datetime":{"type":"string","description":"ISO 8601 datetime or 'YYYY-MM-DD HH:mm'"},"reference":{"type":"string","description":"ISO date used as the reference for relative phrases in `query`"}}},"responseSchema":{"type":"json","example":{"to_zone":"Asia/Tokyo","from_zone":"America/Los_Angeles","result_iso":"2026-06-02T07:00:00.000+09:00","result_human":"June 2, 2026, 7:00:00 AM Japan Standard Time","interpreted_query":"2026-06-01 15:00 America/Los_Angeles","offset_difference_hours":16}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fkmRbYYosoOGY6zntsuHM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a datetime from one IANA timezone to another, supporting both structured ISO 8601 input and natural language queries like '3pm PT next Thursday in IST'.","exampleAgentPrompt":"What time is 3pm Pacific Time this coming Thursday in IST? I need to know so I can send a meeting invite with the right time for my colleague in India.","exampleUseCases":null,"resultDescription":"Returns a JSON object with the target timezone, source timezone, the converted datetime in ISO 8601 format with offset, a human-readable datetime string in the target zone, the original interpreted query, and the UTC offset difference in hours between source and target.","failureModes":["Invalid or unrecognized IANA timezone string returns an error","Ambiguous natural language query that cannot be parsed returns an error","Providing both 'query' and 'datetime'/'from' simultaneously (mutually exclusive inputs) returns a validation error","Missing required 'to' field returns a validation error","Payment not settled via x402 protocol returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need to convert a specific datetime (structured or natural language) between IANA timezones and want both a machine-readable ISO result and a human-readable string. Especially useful when the user phrases the time in natural language like '3pm PT next Thursday'. Prefer this over generic date libraries when you need server-side parsing of relative phrases against a reference date, or when you need the offset difference explicitly returned.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:32:06.053Z","isFirstParty":false,"canonicalSlug":"x402-tools-timezone-math-b871de78"}