Date/Time Utilities

Parse Date

Parse Date converts human-readable date strings into structured formats. Use via MCP tools in Cursor or Windsurf, or call GET /v1/datetime/parse directly. Handles formats like "March 15, 2024", "2024-03-15T10:30:00Z", or "next Tuesday". Returns standardized ISO timestamps, preventing AI agents from generating incorrect date calculations.

API Endpoint

GET /v1/datetime/parse

Code Examples

curl "https://tinyfn.io/v1/datetime/parse" \
  -H "X-API-Key: YOUR_API_KEY"
const response = await fetch('https://tinyfn.io/v1/datetime/parse', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
const data = await response.json();
console.log(data);
import requests

response = requests.get('https://tinyfn.io/v1/datetime/parse',
    headers={'X-API-Key': 'YOUR_API_KEY'})
data = response.json()
print(data)

Use via MCP

Add to your AI agent

Connect your AI agent (Claude, Cursor, Windsurf, etc.) to TinyFn's date/time tools:

{
  "mcpServers": {
    "tinyfn-datetime": {
      "url": "https://tinyfn.io/mcp/datetime",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Learn more about MCP setup →

FAQ

What date formats can Parse Date handle?

Supports ISO 8601, RFC formats, natural language ("next Monday", "in 3 days"), and common patterns like MM/DD/YYYY, DD-MM-YYYY, and "March 15, 2024".

How do I use Parse Date in MCP-enabled AI tools?

Simply reference date parsing in your prompt. The AI agent will call the MCP tool automatically, ensuring accurate date interpretation instead of hallucinated results.

What does Parse Date return for ambiguous dates?

Returns structured data with the parsed timestamp, detected format, and timezone information. Ambiguous formats like "01/02/2024" follow configurable locale conventions.

Can Parse Date handle relative dates like "tomorrow" or "last week"?

Yes, it processes relative expressions based on the current system time, returning absolute timestamps for consistent date calculations across applications.

Does Parse Date work with different timezones?

Handles timezone-aware parsing, converting to UTC by default. Supports timezone abbreviations, offsets (+05:00), and named zones (America/New_York).

Try Parse Date Now

Get your free API key and start using Parse Date in seconds.

Get Free API Key