Work out how long there is between two times of day, with no dates involved. Handles a shift that crosses midnight — 22:00 to 06:00 is eight hours, not minus sixteen — and can subtract an unpaid break. Accepts 24-hour times and am/pm, and returns the duration both as hours and minutes and as decimal hours for invoicing.
This page documents the HTTP endpoint POST /api/tools/time-difference/execute. See the MCP reference →
Call it over REST
POST https://api.findutils.com/api/tools/time-difference/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
curl -X POST https://api.findutils.com/api/tools/time-difference/execute \
-H "Content-Type: application/json" \
-d '{
"start": "22:00",
"end": "06:00"
}'Parameter schema for this endpoint
curl https://api.findutils.com/api/tools/time-differenceInput schema
| Argument | Type | Required | Description |
|---|---|---|---|
| start | string | yes | Start time: "09:00", "9:00:30" or "9:00 am". |
| end | string | yes | End time, same formats. "24:00" means the end of the day. |
| overnight | string (auto | always | never) | no | auto wraps past midnight only when the end is not after the start. always puts the end on the NEXT day, so 09:00 to 17:00 becomes 32 hours. never refuses to wrap and errors instead. Default: auto. Default: "auto". |
| break_minutes | number | no | Unpaid break to subtract, in minutes. Default: 0. Default: 0. |
Example arguments (verified)
{
"start": "22:00",
"end": "06:00"
}Also an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:time_difference after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/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-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.
Date Difference Calculator
Calculate the difference between two dates in various units.
Pdf Delete Pages
Remove pages from a PDF and return the rest in their original order.