java.lang.Object | ||||
↳ | org.joda.time.Chronology | |||
↳ | org.joda.time.chrono.BaseChronology | |||
↳ | org.joda.time.chrono.AssembledChronology | |||
↳ | org.joda.time.chrono.LimitChronology |
Wraps another Chronology to impose limits on the range of instants that the fields within a Chronology may support. The limits are applied to both DateTimeFields and DurationFields.
Methods in DateTimeField and DurationField throw an IllegalArgumentException whenever given an input instant that is outside the limits or when an attempt is made to move an instant outside the limits.
LimitChronology is thread-safe and immutable.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
A limit chronology is only equal to a limit chronology with the
same base chronology and limits.
| |||||||||||
Returns a datetime millisecond instant, formed from the given year,
month, day, hour, minute, second, and millisecond values.
| |||||||||||
Returns a datetime millisecond instant, formed from the given year,
month, day, and millisecond values.
| |||||||||||
Returns a datetime millisecond instant, from from the given instant,
hour, minute, second, and millisecond values.
| |||||||||||
Wraps another chronology, with datetime limits.
| |||||||||||
Returns the inclusive lower limit instant.
| |||||||||||
Returns the inclusive upper limit instant.
| |||||||||||
A suitable hashcode for the chronology.
| |||||||||||
A debugging string for the chronology.
| |||||||||||
If this LimitChronology is already UTC, then this is
returned.
| |||||||||||
If this LimitChronology has the same time zone as the one given, then
this is returned.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Invoked by the constructor and after deserialization to allow subclasses
to define all of its supported fields.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
org.joda.time.chrono.AssembledChronology
| |||||||||||
From class
org.joda.time.chrono.BaseChronology
| |||||||||||
From class
org.joda.time.Chronology
| |||||||||||
From class
java.lang.Object
|
A limit chronology is only equal to a limit chronology with the same base chronology and limits.
obj | the object to compare to |
---|
Returns a datetime millisecond instant, formed from the given year, month, day, hour, minute, second, and millisecond values. The set of given values must refer to a valid datetime, or else an IllegalArgumentException is thrown.
The default implementation calls upon separate DateTimeFields to determine the result. Subclasses are encouraged to provide a more efficient implementation.
year | year to use |
---|---|
monthOfYear | month to use |
dayOfMonth | day of month to use |
hourOfDay | hour to use |
minuteOfHour | minute to use |
secondOfMinute | second to use |
millisOfSecond | millisecond to use |
IllegalArgumentException |
---|
Returns a datetime millisecond instant, formed from the given year, month, day, and millisecond values. The set of given values must refer to a valid datetime, or else an IllegalArgumentException is thrown.
The default implementation calls upon separate DateTimeFields to determine the result. Subclasses are encouraged to provide a more efficient implementation.
year | year to use |
---|---|
monthOfYear | month to use |
dayOfMonth | day of month to use |
millisOfDay | millisecond to use |
IllegalArgumentException |
---|
Returns a datetime millisecond instant, from from the given instant, hour, minute, second, and millisecond values. The set of given values must refer to a valid datetime, or else an IllegalArgumentException is thrown.
The default implementation calls upon separate DateTimeFields to determine the result. Subclasses are encouraged to provide a more efficient implementation.
instant | instant to start from |
---|---|
hourOfDay | hour to use |
minuteOfHour | minute to use |
secondOfMinute | second to use |
millisOfSecond | millisecond to use |
IllegalArgumentException |
---|
Wraps another chronology, with datetime limits. When withUTC or withZone is called, the returned LimitChronology instance has the same limits, except they are time zone adjusted.
base | base chronology to wrap |
---|---|
lowerLimit | inclusive lower limit, or null if none |
upperLimit | exclusive upper limit, or null if none |
IllegalArgumentException | if chronology is null or limits are invalid |
---|
A suitable hashcode for the chronology.
If this LimitChronology is already UTC, then this is returned. Otherwise, a new instance is returned, with the limits adjusted to the new time zone.
If this LimitChronology has the same time zone as the one given, then this is returned. Otherwise, a new instance is returned, with the limits adjusted to the new time zone.
zone | to use, or default if null |
---|
Invoked by the constructor and after deserialization to allow subclasses to define all of its supported fields. All unset fields default to unsupported instances.
fields | container of fields |
---|