There are a few problems with the current spec for comparing date/time with the Calendar methods:
- The after() and before() methods take an Object and return false if the given Object isn't a Calendar instance. (4682471)
- equals() documentation doesn't mention that the lenient, firstDayOfWeek, etc. are parameters for the comparison. This must be documented.
- Calendar should support Comparable so that only the time values can be compared (without taking other parameters (lenient, firstDayOfWeek, etc.).
- These methods shouldn't modify the state of this and given Objects.