com.massa.util

Class DateUtils

java.lang.Object

com.massa.util.DateUtils

public class DateUtils
extends Object

Utilities class to perform operations on Date / Time. Accepted date formats are all the ones available in the JDK (java.util.Date, Calendar, SQL types, ...).
The Java time package objects are not handled, the JDK8 extension must be used for this purpose.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DateUtils.DateOperation This class is used to store directives for Dates (or time) manipulation.
static interface	DateUtils.IDateOperation This class is used to describe directives for Dates (or time) manipulation, i.e. adding year(s), month(s), day(s), hour(s), minute(s), second(s) or milli(s) to a provided date.

Field Summary

Fields

Modifier and Type	Field and Description
static long	MILLIS_IN_SECOND
static int	MINUTES_IN_HOUR
static int	SECONDS_IN_MINUTE

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DateUtils()

Method Summary

Modifier and Type	Method and Description
long	diff(Calendar d1, Calendar d2, char field)
protected long	diffInDay(Calendar d1, Calendar d2)
protected long	diffInHour(Calendar d1, Calendar d2)
protected long	diffInMilli(Calendar d1, Calendar d2)
protected long	diffInMinute(Calendar d1, Calendar d2)
protected long	diffInMonth(Calendar d1, Calendar d2)
protected long	diffInSecond(Calendar d1, Calendar d2)
protected long	diffInYear(Calendar d1, Calendar d2)
Calendar	execute(Calendar c, DateUtils.IDateOperation operation) Handles operations on Calendar.
Date	execute(Date d, DateUtils.IDateOperation operation) Handles operations on Date.
Date	execute(Date d, DateUtils.IDateOperation operation) Handles operations on java.sql.Date.
Time	execute(Time d, DateUtils.IDateOperation operation) Handles operations on java.sql.Time.
Timestamp	execute(Timestamp d, DateUtils.IDateOperation operation) Handles operations on java.sql.Timestamp.
XMLGregorianCalendar	execute(XMLGregorianCalendar c, DateUtils.IDateOperation operation) Handles operations on XMLGregorianCalendar.
static DateUtils	getDefaultInstance() Get default global instance.
protected <A extends Calendar> A	update(A c, DateUtils.IDateOperation operation) Updates the provided calendar, without creating a new instance.

Methods inherited from class java.lang.Object

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

Field Detail

MINUTES_IN_HOUR

public static final int MINUTES_IN_HOUR

See Also:

Constant Field Values

SECONDS_IN_MINUTE

public static final int SECONDS_IN_MINUTE

See Also:

Constant Field Values

MILLIS_IN_SECOND

public static final long MILLIS_IN_SECOND

See Also:

Constant Field Values

Constructor Detail

DateUtils

protected DateUtils()

Method Detail

getDefaultInstance

public static DateUtils getDefaultInstance()

Get default global instance.

execute

public Calendar execute(Calendar c,
                        DateUtils.IDateOperation operation)

Handles operations on Calendar.

Parameters:

c - The input Calendar.

operation - The operation to perform.

Returns:

A different instance of calendar.

execute

public XMLGregorianCalendar execute(XMLGregorianCalendar c,
                                    DateUtils.IDateOperation operation)
                             throws UtilsException

Handles operations on XMLGregorianCalendar.

Parameters:

c - The input Calendar.

operation - The operation to perform.

Returns:

A different instance of calendar.

Throws:

UtilsException - If XMLGregorianCalendar could not be instantiated

execute

public Date execute(Date d,
                    DateUtils.IDateOperation operation)

Handles operations on Date.

Parameters:

d - The input Date.

operation - The operation to perform.

Returns:

A different instance of Date.

execute

public Date execute(Date d,
                    DateUtils.IDateOperation operation)

Handles operations on java.sql.Date.

Parameters:

d - The input java.sql.Date.

operation - The operation to perform.

Returns:

A different instance of java.sql.Date.

execute

public Time execute(Time d,
                    DateUtils.IDateOperation operation)

Handles operations on java.sql.Time.

Parameters:

d - The input java.sql.Time.

operation - The operation to perform.

Returns:

A different instance of java.sql.Time.

execute

public Timestamp execute(Timestamp d,
                         DateUtils.IDateOperation operation)

Handles operations on java.sql.Timestamp.

Parameters:

d - The input java.sql.Timestamp.

operation - The operation to perform.

Returns:

A different instance of java.sql.Timestamp.

update

protected <A extends Calendar> A update(A c,
                                        DateUtils.IDateOperation operation)

Updates the provided calendar, without creating a new instance.

Returns:

The same Calendar instance for chaining.

diff

public long diff(Calendar d1,
                 Calendar d2,
                 char field)

diffInMilli

protected long diffInMilli(Calendar d1,
                           Calendar d2)

diffInSecond

protected long diffInSecond(Calendar d1,
                            Calendar d2)

diffInMinute

protected long diffInMinute(Calendar d1,
                            Calendar d2)

diffInHour

protected long diffInHour(Calendar d1,
                          Calendar d2)

diffInDay

protected long diffInDay(Calendar d1,
                         Calendar d2)

diffInMonth

protected long diffInMonth(Calendar d1,
                           Calendar d2)

diffInYear

protected long diffInYear(Calendar d1,
                          Calendar d2)