Date Difference API

POST https://api.findutils.com/api/tools/date-difference/execute

Compute the difference between two dates in years/months/weeks/days/hours/minutes/seconds.

Request body

application/json

start

string required

Start date (ISO 8601 or YYYY-MM-DD).
end

string optional

End date. Defaults to today.

Example arguments

Verified

{
  "start": "2020-01-01",
  "end": "2021-01-01"
}

Age Calculate Calculate age from a date of birth — years, months, days, plus totals in days, weeks, and months.
Career Experience Calculator Calculate total professional experience across several jobs: total days, years/months/days, weeks, working days (5/7), working hours (8 per…
Country Lookup Return country facts — capital, currency (name, code, symbol), phone code, timezone, region, subregion, flag emoji, and languages…
Cron Describe Parse a 5-field cron expression (minute hour day-of-month month day-of-week) and produce a human-readable English description.
Cron To Systemd Convert a 5-field cron expression into a systemd timer plus service unit and a Kubernetes CronJob YAML file.
Date Difference Calculator Calculate the difference between two dates in various units.

curl -X POST https://api.findutils.com/api/tools/date-difference/execute \
  -H "Content-Type: application/json" \
  -d '{
    "start": "2020-01-01",
    "end": "2021-01-01"
  }'

const response = await fetch('https://api.findutils.com/api/tools/date-difference/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"start":"2020-01-01","end":"2021-01-01"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/date-difference/execute",
    json={"start":"2020-01-01","end":"2021-01-01"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/date-difference/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"start":"2020-01-01","end":"2021-01-01"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

Also an MCP tool

Call date_difference from Claude, Cursor or any MCP client. Same arguments, same output.

https://mcp.findutils.com

MCP reference

Rate limit: 60 a minute, per IP
Auth: None
REST id: date-difference
MCP name: date_difference
Category: Date & time
Machine-readable: openapi.json · markdown.md

Request body

Example arguments

More Date & time tools

More to explore