{"uid":"cap_qDnlaBeYpTi4KeyfHgjmS","slug":"datetime-openverbs-com-date-time-difference-calculator-09f98ae7","name":"datetime.openverbs.com – Date/Time Difference Calculator","description":"Compute the calendar breakdown (years, months, days, hours, minutes, seconds) between two ISO 8601 dates/date-times, plus exact totalSeconds. If end precedes start the result is flagged negative rather than erroring.","url":"https://datetime.openverbs.com/v1/between","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["start","end"],"properties":{"end":{"type":"string","maxLength":64,"minLength":4,"description":"End ISO 8601 date or date-time."},"start":{"type":"string","maxLength":64,"minLength":4,"description":"Start ISO 8601 date or date-time."}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"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_w3reDiyr9SywK43-cF2m4","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":"Computes the calendar breakdown (years, months, days, hours, minutes, seconds) and total seconds between two ISO 8601 dates or date-times, flagging negative results when end precedes start.","exampleAgentPrompt":"How much time is there between 1985-07-15T09:00:00 and 2024-11-30T17:45:00? I need the full breakdown — years, months, days, hours, minutes, seconds, and total seconds.","exampleUseCases":[{"title":"Calculate someone's exact age","prompt":"My friend was born on 1990-03-22T00:00:00 and today is 2025-06-10T12:00:00 — can you tell me their exact age in years, months, days, and also the total seconds they've been alive?"},{"title":"Time remaining until project deadline","prompt":"Our project deadline is 2025-12-31T23:59:59 and right now it's 2025-06-10T09:00:00 — how much time do we have left, broken down into years, months, days, hours, and minutes?"},{"title":"Audit elapsed time between system events","prompt":"I have two server event timestamps: the first event was at 2024-01-15T08:22:10 and the second at 2024-01-17T14:55:45. What's the exact calendar difference between them in hours, minutes, and seconds, plus total seconds?"}],"resultDescription":"Returns a calendar breakdown object with integer fields for years, months, days, hours, minutes, and seconds representing the interval between the two input datetimes, plus an exact totalSeconds value. If the end datetime precedes the start, the response includes a negative flag rather than returning an error.","failureModes":["Invalid or malformed ISO 8601 string returns a 400 error","Input strings shorter than 4 or longer than 64 characters are rejected by schema validation","Missing required 'start' or 'end' fields cause a validation error","Ambiguous date strings that don't conform to ISO 8601 may fail to parse","Network timeout if the service is temporarily unavailable"],"whenToPreferThis":"Choose this endpoint when you need a full calendar-unit breakdown (years, months, days, hours, minutes, seconds) of the interval between two ISO 8601 datetimes, especially when you also need an exact totalSeconds value and want graceful handling of reversed date order (negative flag instead of error). Prefer this over manual arithmetic when calendar-accurate month and year counting is required, not just raw seconds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:47:52.544Z","isFirstParty":false}