Date Difference Calculator API

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

Calculate the difference between two dates in various units.

Request body

application/json

from

string required

Start date (ISO 8601 or any parseable date string).
to

string optional

End date (ISO 8601 or any parseable date string). Defaults to now if omitted.

Example arguments

Verified

{
  "from": "2024-01-01",
  "to": "2024-12-31"
}

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 Compute the difference between two dates in years/months/weeks/days/hours/minutes/seconds.

curl -X POST https://api.findutils.com/api/tools/date-diff/execute \
  -H "Content-Type: application/json" \
  -d '{
    "from": "2024-01-01",
    "to": "2024-12-31"
  }'

const response = await fetch('https://api.findutils.com/api/tools/date-diff/execute', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({"from":"2024-01-01","to":"2024-12-31"}),
});
const data = await response.json();

import requests

response = requests.post(
    "https://api.findutils.com/api/tools/date-diff/execute",
    json={"from":"2024-01-01","to":"2024-12-31"},
)
data = response.json()

$ch = curl_init('https://api.findutils.com/api/tools/date-diff/execute');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"from":"2024-01-01","to":"2024-12-31"}',
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);

This tool is served over REST only. 369 other tools are callable from AI clients on the MCP server.

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

Request body

Example arguments

More Date & time tools

More to explore