API Method /events/dates/resolve

Given a date string in most common formats, return a start_date and end_date in ISO 8601 format, suitable for /events/new. Uses the current date to make assumptions about relative dates.

For example, the where string "Feb 15 8pm-10pm", submitted in January 2007, would resolve to a start_date of "2007-02-15T20:00:00" and an end_date of "2007-02-15T22:00:00". Dates without times are assumed to be all-day events, so "February 27th" would resolve to a start_date of "2007-02-27T00:00:00" with the all_day flag set to 1.


This method does not require user authentication.
when string
A string containing a date and optional time(s).

Example Request


Output Parameters

Output from this function is an XML block with the following constructs.
status string
"ok" if the provided date string could be resolved, "fail" if not.
original string
The original where string provided.
date_used string
The parts of the original string which were used to determine this date.
start_time date
The start_time implied by the date string, in ISO 8601 format.
end_time date
The end_time implied by the date string, in ISO 8601 format.
all_day boolean
1 (true) if this event happens all day or has no specific time.

Example XML Responses

<?xml version="1.0" encoding="UTF-8"?>
  <original>Feb 15 8pm-10pm</original>
  <date_used>Feb 15, 8pm - 10pm</date_used>
<?xml version="1.0" encoding="UTF-8"?>
  <original>Femberary Twenth</original>