{"uid":"cap_qHlLfBAPZnEKRKN_Hfckq","slug":"date-difference-calculator-215a11a1","name":"Date Difference Calculator","description":"Exact difference between two dates as years, months and days, plus total days, weeks and whole months.","url":"https://timezone-time.x402tookit.com/date-diff?utm_source=zero.xyz","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":["start","end"],"properties":{"end":{"type":"string","description":"YYYY-MM-DD"},"start":{"type":"string","description":"YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"end":{"type":["null","string"]},"asOf":{"type":["null","string"]},"days":{"type":["null","number"]},"start":{"type":["null","string"]},"years":{"type":["null","number"]},"months":{"type":["null","number"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"direction":{"type":["null","string"]},"totalDays":{"type":["null","number"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"totalWeeks":{"type":["null","number"]},"totalMonthsWhole":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HZISgNId_3CNGvGKmt1iS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the exact difference between two dates as years, months, and days, plus total days, weeks, and whole months.","exampleAgentPrompt":"How many years, months, and days are between 2015-03-14 and 2024-11-01, and what's that in total weeks and days?","exampleUseCases":[{"title":"Project duration calculation","prompt":"How long did our project run? It started on 2022-06-15 and ended on 2024-02-28 — give me the difference in years, months, and days, and also the total number of days."},{"title":"Countdown to a future deadline","prompt":"How many days, weeks, and months are there between today (2025-07-10) and the contract deadline on 2026-01-01?"},{"title":"Historical time span research","prompt":"What is the exact difference in years, months, and days between the date World War II ended (1945-09-02) and the moon landing (1969-07-20)?"}],"resultDescription":"Returns the exact difference between two YYYY-MM-DD dates broken down into years, months, and days, plus total days, total weeks, total whole months, the direction (which date is earlier), and a human-readable summary. May include a disclaimer and degraded flag if something unusual occurred.","failureModes":["Missing required query parameters 'start' or 'end' returns an error","Malformed date strings not in YYYY-MM-DD format will cause a parsing error","Invalid calendar dates (e.g. 2023-02-30) will be rejected","Network or service unavailability may return a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need a precise, broken-down date difference — years, months, and days simultaneously — rather than just a raw day count. Ideal for displaying human-readable durations, calculating contract lengths, age differences between historical events, or any context where both component breakdown and total counts are needed together.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-24T03:26:14.888Z","isFirstParty":false,"canonicalSlug":"date-difference-calculator-215a11a1"}