{"uid":"cap_LUmRr9dLXJND3MfKBgrv5","slug":"agenttools-date-difference-calculator-670e2a50","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://agentstoolshub.com/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.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-ZZjzRtT1ezWP4R6v1_2_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the total days between two dates, plus breakdowns in weeks/days and calendar years/months/days.","exampleAgentPrompt":"How many days, weeks, and calendar months are between 2023-01-15 and 2025-06-30?","exampleUseCases":[{"title":"Project deadline days remaining","prompt":"How many total days and weeks are left between today, 2025-07-10, and my project deadline on 2025-12-31?"},{"title":"Age in years months and days","prompt":"I was born on 1990-03-22 — as of 2025-07-10, how old am I in years, months, and days?"},{"title":"Contract duration breakdown","prompt":"My contract runs from 2024-09-01 to 2026-02-28 — can you tell me the total number of days and the breakdown in calendar years, months, and days?"}],"resultDescription":"Returns the total number of days between the two dates, the equivalent broken down into complete weeks plus remaining days, and the full calendar breakdown in years, months, and days.","failureModes":["Invalid date format (not ISO YYYY-MM-DD) returns an error","Start date after end date may return a negative or zero result","Missing required start or end parameter returns a 400-level error","Out-of-range or non-existent dates (e.g. 2023-02-30) may cause parsing errors"],"whenToPreferThis":"Use this endpoint when you need a precise, structured date-difference calculation that includes multiple representations simultaneously — total days, weeks+days, and calendar years/months/days — rather than computing only one metric manually. Ideal for scheduling, contract management, age calculation, or any workflow needing a full temporal breakdown between two known dates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:50:36.770Z","isFirstParty":false,"canonicalSlug":"agenttools-date-difference-calculator-670e2a50"}