# AgentTools Date Difference Calculator

> AgentTools Date Difference Calculator is a paid API for AI agents from agenttools-hub.vercel.app, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-02).

Calculate the total number of days between two dates, with breakdowns in weeks+days and calendar years+months+days

## Facts

- Endpoint: GET https://agenttools-hub.vercel.app/api/v1/calculators/date-difference-calculator?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenttools-date-difference-calculator-5cb6d565
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MyGj_LgYPti_GkDv2RSTn

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agenttools-date-difference-calculator-5cb6d565
```

Example prompt: How many days are between January 15, 2020 and March 22, 2025? Also break it down in weeks and in years, months, and days.

## When to prefer this

Choose this endpoint when you need a structured multi-format breakdown of the time between two calendar dates — specifically when you need both a raw day count and human-readable breakdowns (weeks+days and years+months+days) in a single call. Prefer it over manual arithmetic or generic LLM computation when you need reliable, deterministic results. Well-suited for scheduling, project management, age calculation, or any scenario requiring precise date interval math.

## Known failure modes

- Missing start or end query parameter returns a 400-level error
- Dates not in ISO YYYY-MM-DD format cause a parse error or bad response
- End date earlier than start date may return negative values or an error
- Invalid date values (e.g. 2023-13-01) will fail validation
- Payment not provided or insufficient USDC balance returns a 402 Payment Required error

## How this service works

Count the total days between two dates, plus the breakdown in weeks and days and in calendar years, months and days. Use this when an agent needs to days, weeks and calendar time between two dates.

## Output

Returns the total number of days between the two dates, plus a breakdown as whole weeks and remaining days, and a breakdown as calendar years, months, and days. All values are computed from the ISO-formatted start and end dates provided.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "start",
      "end"
     ],
     "properties": {
      "end": {
       "type": "string",
       "description": "ISO format YYYY-MM-DD"
      },
      "start": {
       "type": "string",
       "description": "ISO format YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenttools-date-difference-calculator-5cb6d565/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttools-hub.vercel.app](https://www.zero.xyz/host/agenttools-hub.vercel.app/llms.txt)