{"uid":"cap_ljfqNdFshi7pQgqT6k2yn","slug":"agent-data-tools-date-difference-calculator-60d3fb85","name":"Agent Data Tools: Date Difference Calculator","description":"Time between two dates or timestamps: total days, weeks, hours, minutes and seconds, a years-months-days breakdown, and the number of weekdays (Monday-Friday) in between. Use for deadlines, ages and durations.","url":"https://agent-data-tools.revmesh2074.workers.dev/date/diff?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["from","to"],"properties":{"to":{"type":"string","description":"End date or ISO timestamp"},"from":{"type":"string","description":"Start date or ISO timestamp"}}},"responseSchema":{"type":"object","properties":{"days":{"type":"number"},"weeks":{"type":"number"},"years":{"type":"number"},"months":{"type":"number"},"weekdays":{"type":"number"},"remainingDays":{"type":"number"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USD","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.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_8dJLmEDAN7I6y_ktSQ0-5","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates the difference between two dates or timestamps, returning days, weeks, months, years, weekdays, and remaining days.","exampleAgentPrompt":"How many days, weekdays, weeks, and months are there between January 15 2025 and November 30 2025?","exampleUseCases":[{"title":"Project deadline countdown","prompt":"How many days and weekdays are left between today, June 10 2025, and our project deadline on September 1 2025?"},{"title":"Contract duration calculation","prompt":"A contract started on March 1 2024 and ends on February 28 2025 — how many months, weeks, and days is that in total?"},{"title":"Age or anniversary span","prompt":"How many years, months, and days have passed between July 4 1776 and July 4 2025?"}],"resultDescription":"A JSON object with numeric fields: days (total days between the two dates), weeks (decimal weeks), months (whole months), years (whole years), weekdays (business days excluding weekends), and remainingDays (days remaining after whole months are accounted for).","failureModes":["Missing 'from' or 'to' query parameter returns an error","Invalid or unparseable date string causes a bad request error","Payment failure via x402 results in no charge and no response","Reversed date order (from > to) may return negative or unexpected values"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a fast, low-cost ($0.001 USDC), no-account-required computation of the span between two dates in multiple units simultaneously (days, weekdays, weeks, months, years). Ideal for scheduling, deadline tracking, contract duration, and any workflow that needs calendar arithmetic without spinning up a local date library.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:33:42.884Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-date-difference-calculator-60d3fb85"}