Our API automatically recognizes and parses natural language date references like "tomorrow", "next Friday", or "in 2 weeks" into standardized ISO-8601 date strings that are machine-readable.
Time zone aware: Dates are interpreted in the user's current time zone (+00:00). Or set the timezone with timezone in your request.
Context-aware: Understands relative references like "tomorrow" or "next Tuesday"
Ranges: "Any time from Wednesday to Thursday".
Hi Sarah,
I’d like to schedule a 30 minute meeting to go over the proposed Q2 budget reallocation for the marketing team. Would you be available on Wednesday, May 22nd at 10:30 AM?
If that doesn’t work, I’m also available Thursday between 2:00 and 4:00 PM. I can actually do a 1 hour meeting no problem.
Thanks,
Jacob
{
"candidates": [
{
"id": "e96e81fd-e1fd-4513-8ce1-aa95ec248796",
"type": "duration",
"value": {
"quantity": 30,
"unit": "minute"
},
"timex": "PT30M",
"grain": "minute",
"confidence": 0.9,
"source": "rule",
"original_text": "30 minute",
"original_span_start": 34,
"original_span_end": 43
},
{
"id": "7545c8e3-069c-466c-80c8-a824deeea01b",
"value": "2025-05-22T10:30:00+03:00",
"timex": "2025-05-22T10:30:00",
"grain": "minute",
"confidence": 0.9,
"source": "rule",
"original_text": "on wednesday may 22 nd at 10:30 am",
"original_span_start": 146,
"original_span_end": 180
},
{
"id": "f7f5cf6c-6056-4c7b-aca1-0ed9ba3583ab",
"value_start": "2025-05-22T02:00:00+03:00",
"value_end": "2025-05-22T16:00:00+03:00",
"timex_start": "2025-05-22T02:00:00",
"timex_end": "2025-05-22T16:00:00",
"type": "interval",
"grain": "minute_interval",
"confidence": 0.85,
"source": "rule-ambiguous",
"original_text": "thursday between 2:00 and 4:00 pm",
"original_span_start": 224,
"original_span_end": 257
},
{
"id": "5beffabb-93cb-44a8-9ebf-d267504c80cb",
"type": "duration",
"value": {
"quantity": 1,
"unit": "hour"
},
"timex": "PT1H",
"grain": "hour",
"confidence": 0.9,
"source": "rule",
"original_text": "1 hour",
"original_span_start": 279,
"original_span_end": 285
}
],
"needs_clarification": false
}
We use cookies to enhance your experience. By continuing to visit this site you agree to our use of cookies.