{"uid":"cap_oU18XUCbddGtcXa-fXgYk","slug":"datetime-utility-now-convert-add-diff-04bf905f","name":"Datetime Utility — Now, Convert, Add, Diff","description":"Date/time math + timezones. op: now | convert | add | diff. Send { op, time?, timezone?, amount?, unit?, to? }.","url":"https://x402-services-production.up.railway.app/api/datetime","method":"POST","headers":{},"bodySchema":{"type":"object","required":["op"],"properties":{"op":{"type":"string","description":"now, convert, add, or diff"},"to":{"type":"string","description":"end time for diff"},"time":{"type":"string","description":"ISO/epoch input time"},"unit":{"type":"string","description":"s/m/h/d/w for add"},"amount":{"type":"number","description":"amount for add"},"timezone":{"type":"string","description":"IANA tz, e.g. America/New_York"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_4CxukAWVTmtpoaWlO4QEE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs datetime operations including fetching the current time, converting between timezones, adding durations, and computing differences between two timestamps.","exampleAgentPrompt":"What's the current time in America/New_York right now?","exampleUseCases":[{"title":"Current time in specific timezone","prompt":"What's the current time right now in Tokyo (Asia/Tokyo)?"},{"title":"Add duration to a timestamp","prompt":"If I start at 2024-06-01T09:00:00Z and add 5 days, what datetime do I land on?"},{"title":"Difference between two timestamps","prompt":"How much time is there between 2024-01-15T08:00:00Z and 2024-03-22T17:30:00Z?"}],"resultDescription":"Returns the computed datetime result: the current time (for 'now'), a timezone-converted timestamp (for 'convert'), a future/past timestamp after duration addition (for 'add'), or the numeric difference between two timestamps in the requested unit (for 'diff').","failureModes":["Invalid or unrecognized IANA timezone string causes error","Missing required 'op' field returns validation error","Invalid ISO or epoch time format causes parse failure","Missing 'to' field when using 'diff' op causes error","Missing 'amount' or 'unit' field when using 'add' op causes error","Payment not settled or insufficient balance returns 402"],"whenToPreferThis":"Use this endpoint when an AI agent needs reliable, pay-per-call datetime operations without API key setup — especially useful for timezone-aware scheduling, computing deadlines, or anchoring agent workflows to real-world time. Prefer over local computation when you need a consistent external time reference or timezone database.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:02:25.406Z","isFirstParty":false}