# time-humanize

> time-humanize is a paid API for AI agents from x402.agentindex.world, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-02).

Converts a datetime to a human-readable relative time string (e.g. '2 hours ago', 'in 3 days') relative to a reference time (default: now).

## Facts

- Endpoint: GET https://x402.agentindex.world/time/humanize?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/time-humanize-7a62c88e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iIxGAgQueBQ10mDTdjXBU

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 time-humanize-7a62c88e
```

Example prompt: Can you turn '2024-11-15T09:30:00Z' into a human-readable relative time like '2 hours ago' or 'in 3 days', compared to right now?

## When to prefer this

Choose this endpoint when you need to quickly convert an ISO or standard datetime string into a friendly, human-readable relative phrase without writing custom formatting logic. It is ideal for display layers, notifications, feed timestamps, or any agent workflow where showing '3 hours ago' is preferable to a raw timestamp. Prefer it over manual calculation when simplicity, speed, and natural language output matter.

## Known failure modes

- Invalid or unparseable datetime string returns an error
- Malformed reference datetime string causes a parsing failure
- Missing required 'datetime' parameter returns a validation error
- Extremely far-future or far-past dates may produce imprecise output

## How this service works

Human-readable relative time ('2 hours ago', 'in 3 days') between a datetime and a reference (default now).

## Output

Returns a human-readable relative time string such as '2 hours ago', 'in 3 days', 'just now', or 'a month ago', representing the time difference between the provided datetime and the reference point (defaulting to the current time).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "datetime": {
   "type": "string",
   "title": "Datetime"
  },
  "reference": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ],
   "title": "Reference",
   "default": null
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/time-humanize-7a62c88e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentindex.world](https://www.zero.xyz/host/x402.agentindex.world/llms.txt)