adjust_time

Finds an interval within this that corresponds to the given time_, possibly adjusting time_ if required to fit into an interval.

The meaning of time_ depends on type.

This function is similar to find_interval, with the difference that it always succeeds (by making the adjustments described below).

In any of the cases where find_interval succeeds then this function returns the same value, without modifying time_.

This function may, however, modify time_ in order to deal with non-existent times. If the non-existent local time_ of 02:30 were requested on March 14th 2010 in Toronto then this function would adjust time_ to be 03:00 and return the interval containing the adjusted time.

Parameters:

this	a TimeZone
type	the TimeType of time_
time_	a pointer to a number of seconds since January 1, 1970

Returns:

the interval containing time_, never -1