com.neurosys.utils

Class DateRangeUtils

java.lang.Object

com.neurosys.utils.DateRangeUtils

public class DateRangeUtils
extends Object

Common Utilities for DateRanges

Author:

Arjun Dhar

Constructor Summary

Constructors

Constructor and Description
DateRangeUtils()

Method Summary

Modifier and Type	Method and Description
static List<DateRange>	compliment(DateRange e1, DateRange e2) Return a List of DateRange that do not overlap between 2 DateRanges
static boolean	contains(DateRange e1, DateRange e2) Check if e1 contains e2 completely; including bounds
static long	daysDiff(DateRange range, boolean normalizeTime) Calculate number of days difference. Note on Time Zone : It is very important to note that both the date should have the same JVM Time-Zone set in the Date.
static DateRange	intersection(DateRange e1, DateRange e2) Get the overlap of event e1 in e2, including bound conditions Example: If there are 2 Date ranges
static boolean	intersects(DateRange e1, DateRange e2) Check if 2 Date Ranges Overlap; including bounds

Methods inherited from class java.lang.Object

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

Constructor Detail

DateRangeUtils

public DateRangeUtils()

Method Detail

daysDiff

public static long daysDiff(DateRange range,
                            boolean normalizeTime)

Calculate number of days difference.
Note on Time Zone : It is very important to note that both the date should have the same JVM Time-Zone set in the Date. For places with Day Light Saving, like EST Vs EDT this can be a problem.

Parameters:

range - as DateRange

normalizeTime - as boolean, if true will ignore any time settings.

Returns:

long

intersection

public static DateRange intersection(DateRange e1,
                                     DateRange e2)

Get the overlap of event e1 in e2, including bound conditions

Example: If there are 2 Date ranges

 |e1S<-----x--------->e1E|
           |e2S<---------y----->e2E|
 

This function will calculate (x,y) in the above scenario.
Boundary aka Cusp Condition : If there is 1 Date in common, that will fall in the intersection

Parameters:

e1 - as DateRange

e2 - as DateRange

Returns:

AbstractEvent part. If e1 is not overlapping with e2 at all, it will throw an IllegalArgumentException.

Can be null:

true, if there is no overlap

intersects

public static boolean intersects(DateRange e1,
                                 DateRange e2)

Check if 2 Date Ranges Overlap; including bounds

Parameters:

e1 - as DateRange

e2 - as DateRange

Returns:

boolean

contains

public static boolean contains(DateRange e1,
                               DateRange e2)

Check if e1 contains e2 completely; including bounds

Parameters:

e1 - as DateRange

e2 - as DateRange

Returns:

boolean

compliment

public static List<DateRange> compliment(DateRange e1,
                                         DateRange e2)

Return a List of DateRange that do not overlap between 2 DateRanges

Parameters:

e1 - as DateRange

e2 - as DateRange

Returns:

List of DateRange