🗓️Natural Date Parser
Parse natural-language date and time expressions — "in two weeks", "next friday at 3pm", "dec 25th" — into exact ISO 8601 dates. Deterministic parsing (no LLM guessing); relative expressions resolve against a reference moment you control.
Worked examples
"next friday at 3pm"
GET /api/v1/dev/natural-date?text=next%20friday%20at%203pm&ref=2026-10-01T09%3A00%3A00Z
Result: 2026-10-09T15:00:00.000Z
"in two weeks"
GET /api/v1/dev/natural-date?text=remind%20me%20in%20two%20weeks&ref=2026-10-01
Result: 2026-10-15T12:00:00.000Z
"dec 25 2026"
GET /api/v1/dev/natural-date?text=deadline%20is%20dec%2025%202026&ref=2026-10-01
Result: 2026-12-25T12:00:00.000Z
Machine API (x402)
$0.001 / callThis tool is also a JSON API for AI agents. Requests without payment receive 402 Payment Required plus instructions; agents pay USDC on Base via the x402 protocol — no accounts, no API keys.
GET /api/v1/dev/natural-date?text=next%20friday%20at%203pm&ref=2026-10-01T09%3A00%3A00Z HTTP/1.1
Host: agenttools-hub.vercel.app
→ 402 (payment required, instructions in headers)
→ 200 (after X-PAYMENT header; JSON body below)
{
"tool": "dev/natural-date",
"input": {"text":"next friday at 3pm","ref":"2026-10-01T09:00:00Z"},
"result": { "value": 1791558000000, "answer": "2026-10-09T15:00:00.000Z" }
}Agent docs: /llms.txt · OpenAPI spec · integration guide
About this tool
Convert natural-language date expressions into exact ISO 8601 timestamps using the deterministic chrono parser — no language model, no hallucinated dates. Relative expressions ('tomorrow', 'in 3 weeks', 'next friday') resolve against a reference moment you can pin for reproducible results.
chrono.parse(text, reference, { forwardDate: true }) → ISO 8601 (UTC)
Frequently asked questions
Why not just ask an LLM for the date?
Language models invent dates — especially for relative expressions anchored to 'now'. This parser is deterministic: same input and reference always produce the same timestamp.
Which expressions are supported?
Most English patterns: 'tomorrow 9am', 'next friday', 'in 2 weeks', 'dec 25', '3 days ago', 'this weekend', plus times like 'at 3pm'.