Date difference

Calculate the difference between two calendar dates.

The result includes absolute days, weeks, approximate months, approximate years, and whether the end date is before, after, or on the same day as the start date.

The calculation compares date-only UTC values to avoid local daylight-saving offsets changing the day count.

When to use it

Plan project milestones, compare contract start and end dates, or explain approximate month and year spans alongside exact day counts for reporting dashboards.

Limitations

Processing runs in your browser session; very large inputs may be slow or memory-heavy. Edge cases, locale-specific rules, and third-party API semantics may differ—verify critical results independently before relying on them in production or legal contexts.

Example

From 2024-01-01 to 2024-01-14 the date-difference result is a concrete day/second count.

This skill is available over A2A JSON-RPC and REST. When you already know the skill id and export, call execute directly—no discovery step required.

REST example

curl -sS -X POST https://toolplaza.app/api/helpers/execute \
  -H 'Content-Type: application/json' \
  -d '{"skillId":"time__date-difference","export":"calculateDateDifference","args":[10,20]}'

A2A JSON-RPC example

Send POST https://toolplaza.app/api/a2a with:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "message": {
      "messageId": "uuid",
      "role": "user",
      "parts": [
        {
          "kind": "text",
          "text": "ignored"
        }
      ]
    },
    "metadata": {
      "toolplaza": {
        "skillId": "time__date-difference",
        "export": "calculateDateDifference",
        "args": [
          10,
          20
        ]
      }
    }
  }
}

Full Agent API guide · Skill schema