Options are:
[:context]
:past or :future (defaults to :future)
If your string represents a birthday, you can set :context
to :past and if an ambiguous string is given, it will
assume it is in the past. Specify :future or omit to set a
future context.
[:now]
Time (defaults to time())
By setting :now to a Horde_Date, all computations will be
based off of that time instead of time().
[:return]
'result', 'span', or 'date' (defaults to 'date')
By default, the parser will guess a single point in time for the
given date or time. If you'd rather have the entire time span
returned, set :return to 'span' and a Horde_Date_Span will
be returned. If you want the entire result, including tokens (for
retrieving the text that was or was not tagged, for example), set
:return to 'result' and you will get a result object.
[:ambiguousTimeRange]
Integer or :none (defaults to 6 (6am-6pm))
If an Integer is given, ambiguous times (like 5:00) will be assumed
to be within the range of that time in the AM to that time in the
PM. For example, if you set it to 7, then the parser will
look for the time between 7am and 7pm. In the case of 5:00, it would
assume that means 5:00pm. If :none is given, no assumption
will be made, and the first matching instance of that time will be
used.