TempusTotal

Natural Language Dates, Precisely Parsed

Transform expressions like "next friday" or "3 weeks from now" into exact dates. Simple, powerful, and built for humans.

Try These Examples

Click any example to try it out. Start with simple expressions and work your way up to more complex ones.

API Documentation

Access the date parser programmatically through our REST API.

REST API Endpoint

Make GET requests to parse natural language date expressions

Try it out

Endpoint

GET https://tempustotal.com/api/parse?expression={expression}

Query Parameters

expressionThe date expression to parse (URL encoded)

Response Format

expressionThe original expression
dateThe parsed date in ISO format
timestampUnix timestamp in milliseconds
metaAdditional information about the parsed expression

Examples

Simple date

curl 'https://tempustotal.com/api/parse?expression=next%20friday'

Response:

{
  "expression": "next friday",
  "date": "2024-01-10T00:00:00.000Z",
  "timestamp": 1704412800000,
  "meta": {
    "type": "weekday",
    "components": [
      "friday",
      "next"
    ]
  }
}