net.fortuna.ical4j.model

Class DateRange

java.lang.Object

net.fortuna.ical4j.model.DateRange

All Implemented Interfaces:

java.io.Serializable

Direct Known Subclasses:

Period

public class DateRange
extends java.lang.Object
implements java.io.Serializable

Author:

fortuna

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	INCLUSIVE_END A flag indicating whether to include the end of the period in test functions.
static int	INCLUSIVE_START A flag indicating whether to include the start of the period in test functions.

Constructor Summary

Constructors

Constructor and Description
DateRange(java.util.Date start, java.util.Date end)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	adjacent(DateRange range) Decides whether these periods are serial without a gap.
boolean	after(DateRange range) Decides whether this period starts after the given period ends.
boolean	before(DateRange range) Decides whether this period is completed before the given period starts.
boolean	contains(DateRange range) Decides whether the given period is completely contained within this one.
java.util.Date	getRangeEnd()
java.util.Date	getRangeStart()
boolean	includes(java.util.Date date) Determines if the specified date occurs within this period (inclusive of period start and end).
boolean	includes(java.util.Date date, int inclusiveMask) Decides whether a date falls within this period.
boolean	intersects(DateRange range) Decides whether this period intersects with another one.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

INCLUSIVE_START

public static final int INCLUSIVE_START

A flag indicating whether to include the start of the period in test functions.

See Also:

Constant Field Values

INCLUSIVE_END

public static final int INCLUSIVE_END

A flag indicating whether to include the end of the period in test functions.

See Also:

Constant Field Values

Constructor Detail

DateRange

public DateRange(java.util.Date start,
         java.util.Date end)

Parameters:

start - the start of the range

end - the end of the range

Method Detail

getRangeStart

public java.util.Date getRangeStart()

Returns:

the rangeStart

getRangeEnd

public java.util.Date getRangeEnd()

Returns:

the rangeEnd

includes

public final boolean includes(java.util.Date date)

Determines if the specified date occurs within this period (inclusive of period start and end).

Parameters:

date - a date to test for inclusion

Returns:

true if the specified date occurs within the current period

includes

public final boolean includes(java.util.Date date,
               int inclusiveMask)

Decides whether a date falls within this period.

Parameters:

date - the date to be tested

inclusiveMask - specifies whether period start and end are included in the calculation

Returns:

true if the date is in the period, false otherwise

See Also:

INCLUSIVE_START, INCLUSIVE_END

before

public final boolean before(DateRange range)

Decides whether this period is completed before the given period starts.

Parameters:

range - a period that may or may not start after this period ends

Returns:

true if the specified period starts after this periods ends, otherwise false

after

public final boolean after(DateRange range)

Decides whether this period starts after the given period ends.

Parameters:

range - a period that may or may not end before this period starts

Returns:

true if the specified period end before this periods starts, otherwise false

intersects

public final boolean intersects(DateRange range)

Decides whether this period intersects with another one.

Parameters:

range - a possible intersecting period

Returns:

true if the specified period intersects this one, false otherwise.

adjacent

public final boolean adjacent(DateRange range)

Decides whether these periods are serial without a gap.

Parameters:

range - a period to test for adjacency

Returns:

true if one period immediately follows the other, false otherwise

contains

public final boolean contains(DateRange range)

Decides whether the given period is completely contained within this one.

Parameters:

range - the period that may be contained by this one

Returns:

true if this period covers all the dates of the specified period, otherwise false