{"uid":"cap_MyGj_LgYPti_GkDv2RSTn","slug":"agenttools-date-difference-calculator-5cb6d565","name":"AgentTools Date Difference Calculator","description":"Count the total days between two dates, plus the breakdown in weeks and days and in calendar years, months and days. Use this when an agent needs to days, weeks and calendar time between two dates.","url":"https://agenttools-hub.vercel.app/api/v1/calculators/date-difference-calculator?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":"ISO format YYYY-MM-DD"},"start":{"type":"string","description":"ISO format YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MsTMC7vVzS-Xnf0a9TVB-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculate the total number of days between two dates, with breakdowns in weeks+days and calendar years+months+days","exampleAgentPrompt":"How many days are between January 15, 2020 and March 22, 2025? Also break it down in weeks and in years, months, and days.","exampleUseCases":[{"title":"Project duration in weeks","prompt":"How many total days and weeks is it from the project kick-off on 2024-03-01 to the delivery deadline on 2024-11-30?"},{"title":"Age in calendar years and months","prompt":"How long ago was someone born on 1990-07-04 — tell me the total days and also break it down into years, months, and days."},{"title":"Days until an event","prompt":"How many days, weeks, and calendar months are left between today, 2025-06-10, and my wedding date on 2025-12-20?"}],"resultDescription":"Returns the total number of days between the two dates, plus a breakdown as whole weeks and remaining days, and a breakdown as calendar years, months, and days. All values are computed from the ISO-formatted start and end dates provided.","failureModes":["Missing start or end query parameter returns a 400-level error","Dates not in ISO YYYY-MM-DD format cause a parse error or bad response","End date earlier than start date may return negative values or an error","Invalid date values (e.g. 2023-13-01) will fail validation","Payment not provided or insufficient USDC balance returns a 402 Payment Required error"],"whenToPreferThis":"Choose this endpoint when you need a structured multi-format breakdown of the time between two calendar dates — specifically when you need both a raw day count and human-readable breakdowns (weeks+days and years+months+days) in a single call. Prefer it over manual arithmetic or generic LLM computation when you need reliable, deterministic results. Well-suited for scheduling, project management, age calculation, or any scenario requiring precise date interval math.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T12:41:00.323Z","isFirstParty":false,"canonicalSlug":"agenttools-date-difference-calculator-5cb6d565"}