Date Difference Calculator

Datetime REST API

Calculate the difference between two dates in various units.

This page documents the HTTP endpoint POST /api/tools/date-diff/execute.

Call it over REST

POST https://api.findutils.com/api/tools/date-diff/execute · no API keys · 60 requests/min per IP

Execute — verified arguments

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"
  }'

Parameter schema for this endpoint

curl https://api.findutils.com/api/tools/date-diff

Interactive docs · OpenAPI 3.1 spec · All REST tools

Input schema

Argument	Type	Required	Description
from	string	yes	Start date (ISO 8601 or any parseable date string).
to	string	no	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"
}

MCP

This tool is served over the REST API only. 292 other tools are also callable from Claude and any MCP client — see the MCP server.

More Datetime tools

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 — for coun

Cron Describe

Parse a 5- or 6-field cron expression and produce a human-readable description.

Date Difference

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

Relationship Calculator

Calculate how long a relationship has lasted between a start date and a target date: years/months/days, totals in days, weeks, months, hours

Timezone Convert

Convert a datetime between IANA time zones.

Unix Timestamp Convert

Convert between Unix timestamps and ISO dates.