Compares the time values (millisecond offsets from the
Epoch) represented by two
Calendar
objects.
@param anotherCalendar the
Calendar
to be compared.
@return the value
0
if the time represented by the argumentis equal to the time represented by this
Calendar
; a value less than
0
if the time of this
Calendar
is before the time represented by the argument; and a value greater than
0
if the time of this
Calendar
is after the time represented by the argument.
@exception NullPointerException if the specified
Calendar
is
null
.
@exception IllegalArgumentException if the time value of thespecified
Calendar
object can't be obtained due to any invalid calendar values.
@since 1.5