Need to know how long is between two dates? This endpoint computes the precise difference.

Overview

Given a start date and an end date, the endpoint returns the difference in total days, hours, minutes, seconds, and weeks, plus a human-readable string (e.g. "1 year 2 months 3 days").

Date formats

Common formats are auto-detected, including YYYY-MM-DD, YYYY/MM/DD, DD-MM-YYYY, and ISO 8601 (with time-zone). You can also pass an explicit format (e.g. DD-MM-YYYY).

[!NOTE]

When the end date precedes the start date, the returned values are negative.