# datetime.openverbs.com – Date/Time Difference Calculator

> datetime.openverbs.com – Date/Time Difference Calculator is a paid API for AI agents from datetime.openverbs.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Computes the calendar breakdown (years, months, days, hours, minutes, seconds) and total seconds between two ISO 8601 dates or date-times, flagging negative results when end precedes start.

## Facts

- Endpoint: POST https://datetime.openverbs.com/v1/between
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/datetime-openverbs-com-date-time-difference-calculator-09f98ae7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qDnlaBeYpTi4KeyfHgjmS

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 datetime-openverbs-com-date-time-difference-calculator-09f98ae7 -d '<json body>'
```

Example prompt: How much time is there between 1985-07-15T09:00:00 and 2024-11-30T17:45:00? I need the full breakdown — years, months, days, hours, minutes, seconds, and total seconds.

## When to prefer this

Choose this endpoint when you need a full calendar-unit breakdown (years, months, days, hours, minutes, seconds) of the interval between two ISO 8601 datetimes, especially when you also need an exact totalSeconds value and want graceful handling of reversed date order (negative flag instead of error). Prefer this over manual arithmetic when calendar-accurate month and year counting is required, not just raw seconds.

## Known failure modes

- Invalid or malformed ISO 8601 string returns a 400 error
- Input strings shorter than 4 or longer than 64 characters are rejected by schema validation
- Missing required 'start' or 'end' fields cause a validation error
- Ambiguous date strings that don't conform to ISO 8601 may fail to parse
- Network timeout if the service is temporarily unavailable

## How this service works

Compute the calendar breakdown (years, months, days, hours, minutes, seconds) between two ISO 8601 dates/date-times, plus exact totalSeconds. If end precedes start the result is flagged negative rather than erroring.

## Output

Returns a calendar breakdown object with integer fields for years, months, days, hours, minutes, and seconds representing the interval between the two input datetimes, plus an exact totalSeconds value. If the end datetime precedes the start, the response includes a negative flag rather than returning an error.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "required": [
      "start",
      "end"
     ],
     "properties": {
      "end": {
       "type": "string",
       "maxLength": 64,
       "minLength": 4,
       "description": "End ISO 8601 date or date-time."
      },
      "start": {
       "type": "string",
       "maxLength": 64,
       "minLength": 4,
       "description": "Start ISO 8601 date or date-time."
      }
     },
     "additionalProperties": false
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/datetime-openverbs-com-date-time-difference-calculator-09f98ae7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from datetime.openverbs.com](https://www.zero.xyz/host/datetime.openverbs.com/llms.txt)