org.nuiton.util
Class DateUtils

java.lang.Object
  org.nuiton.util.DateUtils

public class DateUtils
extends Object

Library for manipulating dates.

Version:

$Revision: 1869 $ Last update: $Date: 2010-05-25 15:41:02 +0200 (mar., 25 mai 2010) $ by :

Author:

fdesbois

Field Summary

static String	DEFAULT_PATTERN
static String	MONTH_PATTERN

Constructor Summary

DateUtils()

Method Summary

static boolean	between(Date myDate, Date beforeDate, Date afterDate) Check if the first date in argument is included between the two other dates.
static Date	createDate(int dd, int mm, int yy) Create a new date from day, month and year (French version).
static Date	createDate(int s, int m, int h, int dd, int mm, int yy) Create a new date from day, month and year (French version).
static Date	createDateAfterToday(int ddStep, int mmStep, int yyStep) Create a new date after the current date (today) with modification on day, month and year.
static boolean	currentPeriod(Date beforeDate, Date afterDate) Check if the current date is between the two dates in argument.
static String	formatDate(Date date, String pattern) Format a date using the pattern in argument.
static String	formatDate(Date date, String pattern, Locale locale)
static Calendar	getDefaultCalendar(Date date) Get the calendar corresponding to the date.
static int	getDifferenceInDays(Date beginDate, Date endDate) Do the difference between the two dates in argument.
static int	getDifferenceInHours(Date beginDate, Date endDate) Do the difference between the two dates in argument.
static int	getDifferenceInMinutes(Date beginDate, Date endDate) Do the difference between the two dates in argument.
static int	getDifferenceInMonths(Date beginDate, Date endDate) Do the difference between the two dates in argument.
static int	getDifferenceInSeconds(Date beginDate, Date endDate) Do the difference between the two dates in argument.
static int	getMonth(Date date) Get the month value from a date (between 0 and 11).
static String	getMonthLibelle(int monthNumber) Get libelle of the month corresponding to the number given in argument.
static String	getMonthLibelle(int monthNumber, Locale locale) Get libelle of the month corresponding to the number given in argument.
static Date	getYesterday(Date date) Get the date before today
static Date	parseDate(String date, String pattern) Parse a date using the pattern in argument.
static Date	setFirstDayOfMonth(Date date) Set the first day of month to the date in argument.
static Date	setLastDayOfMonth(Date date) Set the last day of month to the date in argument.
static Date	setMaxTimeOfDay(Date date) Set the max time of the day.
static Date	setMinTimeOfDay(Date date) Set the min time of the day : 00:00:00.000.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_PATTERN

public static final String DEFAULT_PATTERN

See Also:

Constant Field Values

MONTH_PATTERN

public static final String MONTH_PATTERN

See Also:

Constant Field Values

Constructor Detail

DateUtils

public DateUtils()

Method Detail

formatDate

public static String formatDate(Date date,
                                String pattern)

Format a date using the pattern in argument. The pattern is the same using for DateFormat object.

Parameters:

date - the date to format

pattern - the pattern to use

Returns:

a String corresponding to the date formatted

See Also:

DateFormat

formatDate

public static String formatDate(Date date,
                                String pattern,
                                Locale locale)

parseDate

public static Date parseDate(String date,
                             String pattern)
                      throws ParseException

Parse a date using the pattern in argument. The pattern is the same using for DateFormat object.

Parameters:

date - the String to parse

pattern - the pattern to use

Returns:

a Date corresponding to the String argument parsed

Throws:

ParseException - for parsing errors

See Also:

DateFormat

createDate

public static Date createDate(int s,
                              int m,
                              int h,
                              int dd,
                              int mm,
                              int yy)

Create a new date from day, month and year (French version). The month is the real month of the year and not the one which is stored in Calendar object.

Parameters:

s - value of the seconds 1-60

m - value of the minutes 1-60

h - value of the hours 1-24

dd - value of the day 1-31

mm - value of the month 1-12

yy - value of the year 0-9999

Returns:

a new date

createDate

public static Date createDate(int dd,
                              int mm,
                              int yy)

Create a new date from day, month and year (French version). The month is the real month of the year and not the one which is stored in Calendar object. Time is set to 00:00:00.000

Parameters:

dd - value of the day 1-31

mm - value of the month 1-12

yy - value of the year 0-9999

Returns:

a new date

createDateAfterToday

public static Date createDateAfterToday(int ddStep,
                                        int mmStep,
                                        int yyStep)

Create a new date after the current date (today) with modification on day, month and year. You can use negative values on arguments to have a date before today.

Parameters:

ddStep - nb days you want to increase from the current date

mmStep - nb months you want to increase from the current date

yyStep - nb years you want to increase from the current date

Returns:

a new date from the current date increase by days, months and years.

setLastDayOfMonth

public static Date setLastDayOfMonth(Date date)

Set the last day of month to the date in argument. The value depends on the month of the date. (30 april, 28 february, ...)

Parameters:

date - Date to modify

Returns:

the date with day of month modified

setFirstDayOfMonth

public static Date setFirstDayOfMonth(Date date)

Set the first day of month to the date in argument.

Parameters:

date - Date to modify

Returns:

the date with day of month modified

setMinTimeOfDay

public static Date setMinTimeOfDay(Date date)

Set the min time of the day : 00:00:00.000.

Parameters:

date - to modify

Returns:

Date with the time set to the minimum in the day

setMaxTimeOfDay

public static Date setMaxTimeOfDay(Date date)

Set the max time of the day. EUROPE : 23:59:59.999.

Parameters:

date - to modify

Returns:

Date with the time set to the maximum in the day

between

public static boolean between(Date myDate,
                              Date beforeDate,
                              Date afterDate)

Check if the first date in argument is included between the two other dates. The argument myDate can be equals to beforeDate or afterDate to validate the includes.

Parameters:

myDate - the date to test

beforeDate - the first date of the period to test

afterDate - the second date of the period to test

Returns:

true if myDate is included between beforeDate and afterDate

currentPeriod

public static boolean currentPeriod(Date beforeDate,
                                    Date afterDate)

Check if the current date is between the two dates in argument.

Parameters:

beforeDate - the first date of the period

afterDate - the second date of the period

Returns:

true if the current date is included between the two dates, false otherwise

See Also:

between(Date, Date, Date)

getMonth

public static int getMonth(Date date)

Get the month value from a date (between 0 and 11).

Parameters:

date - the date to extract month

Returns:

the month value of the date

getDifferenceInSeconds

public static int getDifferenceInSeconds(Date beginDate,
                                         Date endDate)

Do the difference between the two dates in argument. The result is a number of seconds between the two dates.

Parameters:

beginDate - first date

endDate - second date

Returns:

a number of seconds between beginDate and endDate

getDifferenceInMinutes

public static int getDifferenceInMinutes(Date beginDate,
                                         Date endDate)

Do the difference between the two dates in argument. The result is a number of minutes between the two dates.

Parameters:

beginDate - first date

endDate - second date

Returns:

a number of minutes between beginDate and endDate

getDifferenceInHours

public static int getDifferenceInHours(Date beginDate,
                                       Date endDate)

Do the difference between the two dates in argument. The result is a number of hours between the two dates.

Parameters:

beginDate - first date

endDate - second date

Returns:

a number of hours between beginDate and endDate

getDifferenceInDays

public static int getDifferenceInDays(Date beginDate,
                                      Date endDate)

Do the difference between the two dates in argument. The result is a number of days between the two dates. Ex : 28/01/2009 and 08/02/2009 return 11.

Parameters:

beginDate - first date

endDate - second date

Returns:

a number of days between beginDate and endDate

getDifferenceInMonths

public static int getDifferenceInMonths(Date beginDate,
                                        Date endDate)

Do the difference between the two dates in argument. The result is a number of months between the two dates. Ex : 01/01/2009 and 28/02/2009 return 2 months. Warning, if beginDate is inferior to endDate, the result will be 1 minimum

Parameters:

beginDate - first date

endDate - second date

Returns:

a number of months between beginDate and endDate

getMonthLibelle

public static String getMonthLibelle(int monthNumber,
                                     Locale locale)

Get libelle of the month corresponding to the number given in argument.

Parameters:

monthNumber - between 1-12

locale - Locale for language support

Returns:

a String corresponding to the libelle of the month

getMonthLibelle

public static String getMonthLibelle(int monthNumber)

Get libelle of the month corresponding to the number given in argument.

Parameters:

monthNumber - between 1-12

Returns:

a String corresponding to the libelle of the month

getYesterday

public static Date getYesterday(Date date)

Get the date before today

Parameters:

date - concerned

Returns:

Date before today

getDefaultCalendar

public static Calendar getDefaultCalendar(Date date)

Get the calendar corresponding to the date. The default calendar will be returned (default time zone and locale).

Parameters:

date - used to set the calendar time

Returns:

the default calendar with time corresponding to the date