Time Card Calculator: API and MCP

Time Card Calculator over REST and MCP: input fields, limits, outputs, one example request and its real answer. Free, no sign-up.

Id: labor.time-card
Version: 1.0.0
Access: Free
Tool page: Time Card Calculator
Schema: GET /api/v1/tools/labor.time-card

Input

Field	Type	Constraints	Default	Description
`clock`	string	12 \| 24	24	Clock
`starts`	array			Start
`ends`	array			End
`breaks`	array			Break (min)

Output

Field	Type	Description
`duration`	string	Total worked
`decimalHours`	number	Decimal hours (hours)
`totalMinutes`	number	Total minutes (min)
`workedDays`	number	Days worked (days)
`averageHours`	number	Daily average (hours)
`days`	array	Hours worked by day

Example request

curl -X POST https://hesaplayici.com/api/v1/tools/labor.time-card/execute \
  -H 'Content-Type: application/json' \
  -d '{"input":{"clock":"24","starts":["08:30","08:30","09:00","08:45","09:00"],"ends":["17:30","18:00","18:15","16:15","13:00"],"breaks":[60,60,60,30,15]},"locale":"en"}'

Example answer

{
  "output": {
    "duration": "35:30",
    "decimalHours": 35.5,
    "totalMinutes": 2130,
    "workedDays": 5,
    "averageHours": 7.1,
    "days": [
      {
        "day": 1,
        "span": 540,
        "breakMinutes": 60,
        "minutes": 480,
        "hours": 8
      },
      {
        "day": 2,
        "span": 570,
        "breakMinutes": 60,
        "minutes": 510,
        "hours": 8.5
      },
      {
        "day": 3,
        "span": 555,
        "breakMinutes": 60,
        "minutes": 495,
        "hours": 8.25
      },
      {
        "day": 4,
        "span": 450,
        "breakMinutes": 30,
        "minutes": 420,
        "hours": 7
      },
      {
        "day": 5,
        "span": 240,
        "breakMinutes": 15,
        "minutes": 225,
        "hours": 3.75
      }
    ]
  },
  "steps": [
    {
      "id": "day1",
      "formula": "day 1 = end − start − break",
      "substitution": "17:30 − 08:30 − 60 min",
      "value": 480,
      "unit": "min"
    },
    {
      "id": "day2",
      "formula": "day 2 = end − start − break",
      "substitution": "18:00 − 08:30 − 60 min",
      "value": 510,
      "unit": "min"
    },
    {
      "id": "day3",
      "formula": "day 3 = end − start − break",
      "substitution": "18:15 − 09:00 − 60 min",
      "value": 495,
      "unit": "min"
    },
    {
      "id": "day4",
      "formula": "day 4 = end − start − break",
      "substitution": "16:15 − 08:45 − 30 min",
      "value": 420,
      "unit": "min"
    },
    {
      "id": "day5",
      "formula": "day 5 = end − start − break",
      "substitution": "13:00 − 09:00 − 15 min",
      "value": 225,
      "unit": "min"
    },
    {
      "id": "totalMinutes",
      "formula": "total = sum of the days",
      "substitution": "480 + 510 + 495 + 420 + 225",
      "value": 2130,
      "unit": "min"
    },
    {
      "id": "decimalHours",
      "formula": "decimal hours = minutes / 60",
      "substitution": "2,130 / 60",
      "value": 35.5,
      "unit": "hours"
    },
    {
      "id": "averageHours",
      "formula": "daily average = decimal hours / days worked",
      "substitution": "35.5 / 5",
      "value": 7.1,
      "unit": "hours"
    }
  ],
  "notes": [],
  "meta": {
    "toolVersion": "1.0.0",
    "locale": "en"
  },
  "citation": {
    "url": "https://hesaplayici.com/en/salary-and-work/time-card-calculator",
    "title": "Time Card Calculator"
  }
}