ilog.views.gantt

Class IlvTimeUtil

java.lang.Object

ilog.views.gantt.IlvTimeUtil

public final class IlvTimeUtil
extends Object

The IlvTimeUtil class consists of static methods that are of general use when working with Date, Calendar, IlvDuration, and IlvTimeInterval objects. This class is a singleton and instances of this class cannot be created.

Since:

JViews 3.5

Field Summary

Fields

Modifier and Type	Field and Description
static Date	MAX_VALUE The largest value of type Date.
static Date	MIN_VALUE The smallest value of type Date.

Method Summary

Modifier and Type	Method and Description
static Date	add(Date date, IlvDuration delta) Returns a new Date that is the sum of the specified date and duration.
static Date	coerce(Object obj) Coerces the specified object to a Date.
static IlvDuration	max(IlvDuration a, IlvDuration b) Returns the greater of two IlvDuration values.
static IlvDuration	min(IlvDuration a, IlvDuration b) Returns the smaller of two IlvDuration values.
static IlvDuration	subtract(Date date1, Date date2) Returns the difference between the two specified dates.
static Date	subtract(Date date, IlvDuration delta) Returns a new Date that is the specified date minus the specified duration.

Methods inherited from class java.lang.Object

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

Field Detail

MIN_VALUE

public static final Date MIN_VALUE

The smallest value of type Date.

MAX_VALUE

public static final Date MAX_VALUE

The largest value of type Date.

Method Detail

coerce

public static Date coerce(Object obj)

Coerces the specified object to a Date. If the object cannot be converted, an IllegalArgumentException is thrown. The following conversions are currently supported:

• If obj is a Date, it will simply be returned as-is.
• If obj is a Number, then a Date will be constructed from its longValue(), which represents the number of milliseconds since January 1, 1970, 00:00:00 GMT.

Parameters:

obj - The object to coerce.

Returns:

The date conversion of the object.

add

public static Date add(Date date,
                       IlvDuration delta)

Returns a new Date that is the sum of the specified date and duration. Note that this method does not take account of Daylight Saving Time transitions or other timezone and locale dependencies. For logical calendar computations you should use methods of the java.util.Calendar class and the IlvCalendarUtil utility class. For example, to advance a Date by one logical day in the current default timezone and locale, you would use:

 Calendar cal = Calendar.getInstance();
 cal.setTime(aDate);
 cal.add(Calendar.DAY_OF_YEAR, 1);
 Date nextDay = cal.getTime();
 

Parameters:

date - The date.

delta - The duration to add to the date.

Returns:

The date result of the addition.

subtract

public static Date subtract(Date date,
                            IlvDuration delta)

Returns a new Date that is the specified date minus the specified duration. Note that this method does not take account of Daylight Saving Time transitions or other timezone and locale dependencies. For logical calendar computations you should use methods of the java.util.Calendar class and the IlvCalendarUtil utility class. For example, to decrement a Date by one logical day in the current default timezone and locale, you would use:

 Calendar cal = Calendar.getInstance();
 cal.setTime(aDate);
 cal.add(Calendar.DAY_OF_YEAR, -1);
 Date nextDay = cal.getTime();
 

Parameters:

date - The date.

delta - The duration to subtract from the date.

Returns:

The Date result of the subtraction.

subtract

public static IlvDuration subtract(Date date1,
                                   Date date2)

Returns the difference between the two specified dates.

Parameters:

date1 - The date.

date2 - The date to subtract from date1.

Returns:

The date difference.

max

public static IlvDuration max(IlvDuration a,
                              IlvDuration b)

Returns the greater of two IlvDuration values.

Parameters:

a - A duration.

b - Another duration.

Returns:

The larger of a and b.

Since:

JViews 7.5

min

public static IlvDuration min(IlvDuration a,
                              IlvDuration b)

Returns the smaller of two IlvDuration values.

Parameters:

a - A duration.

b - Another duration.

Returns:

The smaller of a and b.

Since:

JViews 7.5