APImcp
GuidesUtilities
ConsoleDocsMCP
Utilities ⏱ 1 min read

Date Duration Calculator API — Calculate Time Between Two Dates

Calculate the duration between two dates in years, months, weeks, days, hours, minutes, and seconds. Free API.

01

What is Duration Calculation?

Duration calculation computes the exact time between two dates and returns the result broken down into years, months, weeks, days, hours, minutes, and seconds. It also returns the total in each unit for flexibility.

02

How to Use It

Call GET /api/v1/duration-calculator?from=2026-01-01&to=2026-06-01. Returns { from: string, to: string, duration: { years: number, months: number, weeks: number, days: number, hours: number, minutes: number, seconds: number }, total_days: number, total_hours: number }.

Try it live Test this endpoint in the interactive console
Open Console →

Frequently Asked Questions

What date formats are supported?
ISO 8601 date formats (YYYY-MM-DD) and ISO 8601 datetime formats (YYYY-MM-DDTHH:mm:ss).