Class IsoInterval<T extends Temporal<? super T>,I extends IsoInterval<T,I>>
 Type Parameters:
T
 temporal type of time points within a given intervalI
 generic selfreferencing interval type
 All Implemented Interfaces:
ChronoInterval<T>
 Direct Known Subclasses:
ClockInterval
,DateInterval
,MomentInterval
,TimestampInterval
Represents an abstract temporal interval on a timeline for ISO8601types.
Note that the start of an interval is (almost) always included (with the exception of intervals with infinite past). The end is open for intervals with infinite future and else included for date intervals by default and excluded for other interval types. This default setting can be overwritten however (although potentially harmful for the performance).
 Since:
 2.0
 Author:
 Meno Hochschild

Method Summary
Modifier and TypeMethodDescriptionboolean
abuts(ChronoInterval<T> other)
Queries if this interval abuts the other one such that there is neither any overlap nor any gap between.collapse()
Changes this interval to an empty interval with the same start anchor.boolean
contains(ChronoInterval<T> other)
Does this interval contain the other one?boolean
Queries if given time point belongs to this interval.boolean
enclosedBy(I other)
ALLENrelation: Equivalent toother.encloses(this)
.boolean
ALLENrelation: Does this interval enclose the other one such that this start is before the start of the other one and this end is after the end of the other one?boolean
Compares the boundaries (start and end) and also the time axis of this and the other interval.boolean
equivalentTo(I other)
ALLENrelation: Does this interval equal the other one taking into account the open or closed state of the boundaries?findIntersection(ChronoInterval<T> other)
Obtains the intersection of this interval and other one if present.boolean
finishedBy(I other)
ALLENrelation: Equivalent toother.finishes(this)
.boolean
ALLENrelation: Does this interval finish the other one such that both end time points are equal and the start of this interval is after the start of the other one?<R> R
get(ChronoFunction<ChronoInterval<T>,R> function)
Lets given query evaluate this interval.getEnd()
Yields the upper bound of this interval.getStart()
Yields the lower bound of this interval.int
hashCode()
boolean
intersects(ChronoInterval<T> other)
Queries if this interval intersects the other one such that there is at least one common time point.boolean
isAfter(ChronoInterval<T> other)
Is this interval after the other one?boolean
Is this interval after the given time point?boolean
isBefore(ChronoInterval<T> other)
Is this interval before the other one?boolean
Is this interval before the given time point?boolean
isEmpty()
Determines if this interval is empty.boolean
ALLENrelation: Does this interval precede the other one such that there is no gap between?boolean
ALLENrelation: Equivalent toother.meets(this)
.boolean
overlappedBy(I other)
ALLENrelation: Equivalent toother.overlaps(this)
.boolean
ALLENrelation: Does this interval overlaps the other one such that the start of this interval is still before the start of the other one?boolean
precededBy(I other)
ALLENrelation: Equivalent toother.precedes(this)
.boolean
ALLENrelation: Does this interval precede the other one such that there is a gap between?print(ChronoPrinter<T> printer)
Prints the canonical form of this interval using a localized interval pattern.void
print(ChronoPrinter<T> startFormat, char separator, ChronoPrinter<T> endFormat, BracketPolicy policy, InfinityStyle infinityStyle, Appendable buffer)
Prints this interval in a technical format using given formatters and separator.print(ChronoPrinter<T> printer, String intervalPattern)
Prints the canonical form of this interval in a custom format.print(ChronoPrinter<T> printer, BracketPolicy policy)
Prints the start and end separated by a slash using given formatter (technical format).boolean
ALLENrelation: Equivalent toother.starts(this)
.boolean
ALLENrelation: Does this interval start the other one such that both start time points are equal and the end of this interval is before the end of the other one?Changes this interval to an interval such that calendrical intervals become closed intervals and other intervals become halfopen.toString()
Yields a descriptive string using the standard output of the methodtoString()
of start and end.Includes the upper boundary of this interval.Includes the lower boundary of this interval.withEnd(UnaryOperator<T> operator)
Yields a copy of this interval with given operator applied on end time.Yields a copy of this interval with given end time.Excludes the upper boundary from this interval.Excludes the lower boundary from this interval.withStart(UnaryOperator<T> operator)
Yields a copy of this interval with given operator applied on start time.Yields a copy of this interval with given start time.<V> ValueInterval<T,I,V>
withValue(V value)
Creates a combination of this interval with an associated value.Methods inherited from interface net.time4j.range.ChronoInterval
isFinite

Method Details

getStart
Description copied from interface:ChronoInterval
Yields the lower bound of this interval.
 Specified by:
getStart
in interfaceChronoInterval<T extends Temporal<? super T>>
 Returns:
 start interval boundary

getEnd
Description copied from interface:ChronoInterval
Yields the upper bound of this interval.
 Specified by:
getEnd
in interfaceChronoInterval<T extends Temporal<? super T>>
 Returns:
 end interval boundary

get
Lets given query evaluate this interval.
 Type Parameters:
R
 generic type of result of query Parameters:
function
 interval query Returns:
 result of query or
null
if undefined  Throws:
ChronoException
 if the given query is not executable Since:
 4.24
 See Also:
HolidayModel.firstBusinessDay()
,HolidayModel.lastBusinessDay()

withStart
Yields a copy of this interval with given start time.
 Parameters:
temporal
 new start timepoint Returns:
 changed copy of this interval
 Throws:
IllegalArgumentException
 if new start is after end Since:
 2.0

withEnd
Yields a copy of this interval with given end time.
 Parameters:
temporal
 new end timepoint Returns:
 changed copy of this interval
 Throws:
IllegalArgumentException
 if new end is before start Since:
 2.0

withStart
Yields a copy of this interval with given operator applied on start time.
 Parameters:
operator
 operator to be applied on the start Returns:
 changed copy of this interval
 Throws:
IllegalStateException
 if the start boundary is infiniteIllegalArgumentException
 if new start is after end Since:
 4.18
 See Also:
withEnd(UnaryOperator)

withEnd
Yields a copy of this interval with given operator applied on end time.
Example:
PlainDate start = PlainDate.of(2014, 2, 27); PlainDate end = PlainDate.of(2014, 5, 20); DateInterval interval = DateInterval.between(start, end).withEnd(PlainDate.DAY_OF_MONTH.maximized()); System.out.println(interval); // [20140227/20140531]
 Parameters:
operator
 operator to be applied on the end Returns:
 changed copy of this interval
 Throws:
IllegalStateException
 if the end boundary is infiniteIllegalArgumentException
 if new end is before start Since:
 4.18
 See Also:
withStart(UnaryOperator)

withOpenStart
Excludes the lower boundary from this interval.
 Returns:
 changed copy of this interval excluding lower boundary
 Since:
 4.21

withClosedStart
Includes the lower boundary of this interval.
 Returns:
 changed copy of this interval including lower boundary
 Throws:
IllegalStateException
 if the start is infinite past Since:
 4.21

withOpenEnd
Excludes the upper boundary from this interval.
 Returns:
 changed copy of this interval excluding upper boundary
 Since:
 2.0

withClosedEnd
Includes the upper boundary of this interval.
 Returns:
 changed copy of this interval including upper boundary
 Throws:
IllegalStateException
 if the end is infinite future Since:
 2.0

isEmpty
public boolean isEmpty()Description copied from interface:ChronoInterval
Determines if this interval is empty.
 Specified by:
isEmpty
in interfaceChronoInterval<T extends Temporal<? super T>>
 Returns:
true
if this interval does not contain any time point elsefalse

isBefore
Description copied from interface:ChronoInterval
Is this interval before the given time point?
 Specified by:
isBefore
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
temporal
 reference time point Returns:
true
if this interval is before given time point elsefalse

isBefore
Is this interval before the other one?
Equivalent to the expression
(precedes(other)  meets(other))
. Specified by:
isBefore
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is before the other one elsefalse
 Since:
 2.0

isAfter
Description copied from interface:ChronoInterval
Is this interval after the given time point?
 Specified by:
isAfter
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
temporal
 reference time point Returns:
true
if this interval is after given time point elsefalse

isAfter
Is this interval after the other one?
Equivalent to the expression
(precededBy(other)  metBy(other))
. Specified by:
isAfter
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is after the other one elsefalse
 Since:
 2.0

contains
Description copied from interface:ChronoInterval
Queries if given time point belongs to this interval.
 Specified by:
contains
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
temporal
 time point to be queried Returns:
true
if given time point belongs to this interval elsefalse

contains
Does this interval contain the other one?
In contrast to
encloses(I)
the interval boundaries may also be equal. Specified by:
contains
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval contains the other one elsefalse
 Since:
 2.0
 See Also:
ChronoInterval.intersects(ChronoInterval)

collapse
Changes this interval to an empty interval with the same start anchor.
 Returns:
 new empty interval with same start (anchor always inclusive)
 Throws:
IllegalStateException
 if the start is infinite Since:
 2.0

toCanonical
Changes this interval to an interval such that calendrical intervals become closed intervals and other intervals become halfopen.
The temporal space will not be changed. Infinite boundaries also remain unchanged.
 Returns:
 new interval with canonical boundaries
 Throws:
IllegalStateException
 if there is no canonical form (for example for [00:00/24:00]) Since:
 3.9/4.6

equals
Compares the boundaries (start and end) and also the time axis of this and the other interval.
Note: Two intervals which are
equivalentTo(I)
to each other are not always equal to each other. For example a halfopen date interval whose end is one day later than the end of a closed date interval with same start is considered equivalent, but not equal. 
hashCode
public final int hashCode() 
toString
Yields a descriptive string using the standard output of the method
toString()
of start and end. 
print
Prints the canonical form of this interval using a localized interval pattern.
If given printer does not contain a reference to a locale then the interval pattern "{0}/{1}" will be used. Note: Starting with version v2.0 and before v3.9/4.6, this method had a different behaviour and just delegated to
print(printer, BracketPolicy.SHOW_WHEN_NON_STANDARD)
. Parameters:
printer
 format object for printing start and end Returns:
 localized formatted string
 Throws:
IllegalStateException
 if the canonicalization of this interval failsIllegalArgumentException
 if an interval boundary is not formattable Since:
 3.9/4.6
 See Also:
toCanonical()
,print(ChronoPrinter, String)
,FormatPatternProvider.getIntervalPattern(Locale)

print
Prints the canonical form of this interval in a custom format.
Example:
DateInterval interval = DateInterval.since(PlainDate.of(2015, 1, 1)); ChronoFormatter<PlainDate> formatter = ChronoFormatter.ofDatePattern("MMM d, uuuu", PatternType.CLDR, Locale.US); System.out.println(interval.print(formatter, "since {0}")); // output: since Jan 1, 2015
 Parameters:
printer
 format object for printing start and end componentsintervalPattern
 interval pattern containing placeholders {0} and {1} (for start and end) Returns:
 formatted string in given pattern format
 Throws:
IllegalStateException
 if the canonicalization of this interval failsIllegalArgumentException
 if an interval boundary is not formattable Since:
 3.9/4.6
 See Also:
toCanonical()

print
Prints the start and end separated by a slash using given formatter (technical format).
Note: Infinite boundaries are printed either as "∞" or "+∞". If given bracket policy is specified as
SHOW_NEVER
then the canonical form of this interval will be printed. Example for an ISOlike representation:DateInterval interval = DateInterval.since(PlainDate.of(2015, 1, 1)); System.out.println( interval.print( Iso8601Format.BASIC_CALENDAR_DATE, BracketPolicy.SHOW_ALWAYS)); // output: [20150101/+∞)
 Parameters:
printer
 format object for printing start and endpolicy
 strategy for printing interval boundaries Returns:
 formatted string in format {start}/{end}
 Throws:
IllegalStateException
 if the canonicalization of this interval failsIllegalArgumentException
 if an interval boundary is not formattable Since:
 2.0

print
public void print(ChronoPrinter<T> startFormat, char separator, ChronoPrinter<T> endFormat, BracketPolicy policy, InfinityStyle infinityStyle, Appendable buffer) throws IOExceptionPrints this interval in a technical format using given formatters and separator.
Note: If given bracket policy is specified as
SHOW_NEVER
then the canonical form of this interval will be printed. Parameters:
startFormat
 format object for printing start componentseparator
 char separating start and end componentendFormat
 format object for printing end componentpolicy
 strategy for printing interval boundariesinfinityStyle
 style to be used for printing infinite interval boundariesbuffer
 writing buffer Throws:
IllegalStateException
 if the canonicalization of this interval fails or given infinity style prevents printing infinite intervalsIllegalArgumentException
 if an interval boundary is not formattableIOException
 if writing to the buffer fails Since:
 3.9/4.6

equivalentTo
ALLENrelation: Does this interval equal the other one taking into account the open or closed state of the boundaries?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is temporally equivalent to the other one elsefalse
 Since:
 2.0

precedes
ALLENrelation: Does this interval precede the other one such that there is a gap between?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is before the other such that there is a gap between elsefalse
 Since:
 2.0
 See Also:
precededBy(IsoInterval)

precededBy
ALLENrelation: Equivalent to
other.precedes(this)
.Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is after the other such that there is a gap between elsefalse
 Since:
 2.0
 See Also:
precedes(IsoInterval)

meets
ALLENrelation: Does this interval precede the other one such that there is no gap between?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is before the other such that there is no gap between elsefalse
 Since:
 2.0
 See Also:
metBy(IsoInterval)

metBy
ALLENrelation: Equivalent to
other.meets(this)
.Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval is after the other such that there is no gap between elsefalse
 Since:
 2.0
 See Also:
meets(IsoInterval)

overlaps
ALLENrelation: Does this interval overlaps the other one such that the start of this interval is still before the start of the other one?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval overlaps the other such that the start of this interval is still before the start of the other one elsefalse
 Since:
 2.0
 See Also:
overlappedBy(IsoInterval)
,intersects(ChronoInterval)

overlappedBy
ALLENrelation: Equivalent to
other.overlaps(this)
.Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if the other interval overlaps this such that the start of the other one is still before the start of this interval elsefalse
 Since:
 2.0
 See Also:
overlaps(IsoInterval)
,intersects(ChronoInterval)

finishes
ALLENrelation: Does this interval finish the other one such that both end time points are equal and the start of this interval is after the start of the other one?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval has the same end point as the other one and a later start elsefalse
 Since:
 2.0
 See Also:
finishedBy(IsoInterval)

finishedBy
ALLENrelation: Equivalent to
other.finishes(this)
.Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval has the same end point as the other one and an earlier start elsefalse
 Since:
 2.0
 See Also:
finishes(IsoInterval)

starts
ALLENrelation: Does this interval start the other one such that both start time points are equal and the end of this interval is before the end of the other one?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval has the same start point as the other one and an earlier end elsefalse
 Since:
 2.0
 See Also:
startedBy(IsoInterval)

startedBy
ALLENrelation: Equivalent to
other.starts(this)
.Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval has the same start point as the other one and a later end elsefalse
 Since:
 2.0
 See Also:
starts(IsoInterval)

encloses
ALLENrelation: Does this interval enclose the other one such that this start is before the start of the other one and this end is after the end of the other one?
Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval has the earlier start point and later end compared to the other one elsefalse
 Since:
 2.0
 See Also:
enclosedBy(IsoInterval)

enclosedBy
ALLENrelation: Equivalent to
other.encloses(this)
.Relation diagram:
 Parameters:
other
 another interval whose relation to this interval is to be investigated Returns:
true
if this interval has the later start point and earlier end compared to the other one elsefalse
 Since:
 2.0
 See Also:
encloses(IsoInterval)

intersects
Queries if this interval intersects the other one such that there is at least one common time point.
 Specified by:
intersects
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
other
 another interval which might have an intersection with this interval Returns:
true
if there is an nonempty intersection of this interval and the other one elsefalse
 Since:
 3.19/4.15
 See Also:
findIntersection(ChronoInterval)
,overlaps(IsoInterval)
,isBefore(ChronoInterval)
,isAfter(ChronoInterval)

findIntersection
Obtains the intersection of this interval and other one if present.
 Parameters:
other
 another interval which might have an intersection with this interval Returns:
 a wrapper around the found intersection or an empty wrapper
 Since:
 4.21
 See Also:
Optional.isPresent()
,intersects(ChronoInterval)

abuts
Queries if this interval abuts the other one such that there is neither any overlap nor any gap between.
Equivalent to the expression
this.meets(other)  this.metBy(other)
. Empty intervals never abut. Specified by:
abuts
in interfaceChronoInterval<T extends Temporal<? super T>>
 Parameters:
other
 another interval which might abut this interval Returns:
true
if there is no intersection and no gap between elsefalse
 Since:
 3.19/4.15
 See Also:
meets(IsoInterval)
,metBy(IsoInterval)

withValue
Creates a combination of this interval with an associated value.
 Type Parameters:
V
 generic value type Parameters:
value
 associated value, notnull
 Returns:
 new value interval
 Since:
 3.31/4.26
