# Date Math Cron Expression Explainer

> Date Math Cron Expression Explainer is a paid API for AI agents from date-math.datemath.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-21).

Translates a cron expression into a plain-English description and lists its next N scheduled run times in any IANA time zone.

## Facts

- Endpoint: POST https://date-math.datemath.workers.dev/v1/cron?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/date-math-cron-expression-explainer-ee6c98e2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qolq0I1uikByRsQffnPDr

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 date-math-cron-expression-explainer-ee6c98e2 -d '<json body>'
```

Example prompt: What does the cron expression '0 9 * * 1-5' mean in plain English, and show me the next 5 times it'll fire in the America/New_York timezone starting from now?

## When to prefer this

Choose this endpoint when you need to both humanize a cron expression and preview its upcoming fire times — especially useful for debugging, documentation, or presenting schedules to non-technical users. It is superior to generic date-math utilities because it handles both explanation and time-zone-aware scheduling preview in a single call, supporting 5- and 6-field cron syntax.

## Known failure modes

- Invalid cron expression returns an error — 6-field vs 5-field mismatches may be rejected
- Unknown or misspelled IANA timezone string causes a validation error
- Count outside the 1–100 range is rejected
- Malformed ISO 8601 'from' datetime returns a parse error
- Network or worker timeout for edge-deployed function (rare)

## How this service works

Date Math: Explain a cron expression in plain English and list its next run times in any time zone. Use to check or debug crontab and scheduled-job schedules.

## Output

Returns the original cron expression, a plain-English description (e.g. 'At 09:00, Monday through Friday'), a from-timestamp, the requested timezone, and an array of next run objects each containing a UTC ISO 8601 timestamp, a local ISO 8601 timestamp with offset, and the weekday name.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "from": {
   "type": "string",
   "description": "ISO 8601 datetime with offset; default now"
  },
  "count": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1,
   "description": "Default 5"
  },
  "timezone": {
   "type": "string",
   "description": "Default UTC"
  },
  "expression": {
   "type": "string",
   "example": "0 9 * * 1-5",
   "description": "5- or 6-field cron expression"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "from": "2026-11-10T13:23:34.584Z",
  "timezone": "Asia/Manila",
  "next_runs": [
   {
    "utc": "2026-11-11T01:00:00Z",
    "local": "2026-11-11T09:00:00+08:00",
    "weekday": "Wednesday"
   }
  ],
  "expression": "0 9 * * 1-5",
  "description": "At 09:00, Monday through Friday"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/date-math-cron-expression-explainer-ee6c98e2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from date-math.datemath.workers.dev](https://www.zero.xyz/host/date-math.datemath.workers.dev/llms.txt)
