com.jalios.util

Class DateUtil

java.lang.Object

com.jalios.util.DateUtil

public class DateUtil
extends java.lang.Object

Date Util

Since:

JCMS 6.3

Author:

Ludovic SMADJA

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	REVISION

Constructor Summary

Constructors

Constructor and Description
DateUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static java.lang.String	formatDuration(java.util.Date begin, java.util.Date end) Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s.
static java.lang.String	formatDuration(java.util.Date begin, java.util.Date end, java.util.Locale locale) Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s
static java.lang.String	formatDuration(long time) Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s.
static java.lang.String	formatDuration(long time, java.util.Locale locale) Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s
static java.lang.String	formatIso8601Date(java.util.Date date) Returns a date formated with the ISO 8601 Date Time format (eg 1999-01-01T14:07:00+0100).
static java.lang.String	formatNoSpaceDate(java.util.Date date) Returns a date formated with the following Date Time format: yyyy-MM-dd_hh-mm-ss This method is thread safe.
static java.lang.String	formatRfc822Date(java.util.Date date) Returns a date formated with the RFC 822 Date Time format (eg Fri, 1 Jan 1999 14:07:00 +0100).
static java.lang.String	formatW3cDate(java.util.Date date) Returns a date formated with the W3C Date Time format (eg 1999-01-01T14:07:00+01:00).
static java.util.Date	getDayEndDate(java.util.Date date, java.util.Locale locale) Get the date of the end of the day (23h59 59s 999 ms)
static java.util.Date	getDayStartDate(java.util.Date date, java.util.Locale locale) Returns the date corresponding to the day start date of a date
static java.util.Date	getNewDateWithoutMillis() Returns the current date with milliseconds reset to 0.
static boolean	isSameDay(java.util.Date date1, java.util.Date date2) Check if the 2 given dates are the same day (from 0h00 included to 0h00 excluded)
static boolean	isToday(java.util.Date date) Check if a given date is the same day as today (from 0h00 included to 0h00 excluded)
static boolean	isTomorrow(java.util.Date date) Check if a given date is the same day as tomorrow (from 0h00 included to 0h00 excluded)
static boolean	isYesterday(java.util.Date date) Check if a given date is the same day as yesterday (from 0h00 included to 0h00 excluded)
static void	mainTestFormatDuration(java.lang.String[] args)
static boolean	overlapWith(java.util.Date startDate, java.util.Date endDate, java.util.Date secondStartDate, java.util.Date secondEndDate) Indicates if both intervals overlaps or not
static boolean	overlapWith(java.util.Date startDate, java.util.Date endDate, java.util.Date secondStartDate, java.util.Date secondEndDate, boolean greedy) Indicates if both intervals overlaps or not
static java.util.Date	parseIso8601Date(java.lang.String source) Returns the date parsed from the given string with the ISO 8601 Date Time format (eg 1999-01-01T14:07:00+0100).
static java.util.Date	parseNoSpaceDate(java.lang.String source) Returns the date parsed from the given string with the following Date Time format: yyyy-MM-dd_hh-mm-ss This method is thread safe.
static java.util.Date	parseRfc822Date(java.lang.String source) Returns the date parsed from the given string with the RFC 822 Date Time format (eg "Fri, 1 Jan 1999 14:07:00 +0100").
static java.util.Date	parseW3cDate(java.lang.String source) Returns the date parsed from the given string with the W3C Date Time format (eg 1999-01-01T14:07:00+01:00).
static void	rollAndAdd(java.util.Calendar calendar, int field, int amount) Do a roll on this calendar instance and add or remove one larger field if the roll action return to the boundary of the period Example roll 1 day for 31/12/2010 will give 01/01/2010.
static long	roundDuration(long duration) Round a duration in order to remove irrelevant information for duration which do not need to be accurate (usually when duration is formatted for the UI).

Methods inherited from class java.lang.Object

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

Field Detail

REVISION

public static final java.lang.String REVISION

See Also:

Constant Field Values

Constructor Detail

DateUtil

public DateUtil()

Method Detail

overlapWith

public static boolean overlapWith(java.util.Date startDate,
                  java.util.Date endDate,
                  java.util.Date secondStartDate,
                  java.util.Date secondEndDate)

Indicates if both intervals overlaps or not

Parameters:

startDate - the low boundary of the first interval

endDate - the high boundary of the first interval

secondStartDate - the low boundary of the second interval

secondEndDate - the high boundary of the second interval

Returns:

true if both interval overlaps, false otherwise

overlapWith

public static boolean overlapWith(java.util.Date startDate,
                  java.util.Date endDate,
                  java.util.Date secondStartDate,
                  java.util.Date secondEndDate,
                  boolean greedy)

Indicates if both intervals overlaps or not

Parameters:

startDate - the low boundary of the first interval

endDate - the high boundary of the first interval

secondStartDate - the low boundary of the second interval

secondEndDate - the high boundary of the second interval

greedy - true if the method shoudl return true when both interval overlap with only one boundary

Returns:

true if both interval overlaps, false otherwise

formatDuration

public static java.lang.String formatDuration(java.util.Date begin,
                              java.util.Date end)

Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s. Use default locale.

Parameters:

begin - the begin date

end - the end date

Returns:

the formatted String

formatDuration

public static java.lang.String formatDuration(java.util.Date begin,
                              java.util.Date end,
                              java.util.Locale locale)

Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s

Parameters:

begin - the begin date

end - the end date

locale - the locale to use

Returns:

the formatted String

formatDuration

public static java.lang.String formatDuration(long time)

Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s. Use default locale.

Parameters:

time - the duration to format (in milliseconds)

Returns:

the formatted String

formatDuration

public static java.lang.String formatDuration(long time,
                              java.util.Locale locale)

Format a duration (i.e split the given time into days, hours, minutes and seconds) E.g.: 124532923 -> 1 day 10 h 35 min 32 s

Parameters:

time - the duration to format (in milliseconds)

locale - the locale to use

Returns:

the formatted String

mainTestFormatDuration

public static void mainTestFormatDuration(java.lang.String[] args)

roundDuration

public static long roundDuration(long duration)

Round a duration in order to remove irrelevant information for duration which do not need to be accurate (usually when duration is formatted for the UI).

As of current implementation, the following rules are applied

• Seconds are removed for duration longer than 5 minutes.
• Minutes are rounded for duration longer than 2 hours (to current hour if minutes are below 30, to next 1 hour if minutes above 30)
• Minutes are removed for duration longer than a day
• Hours are removed for duration longer than a week

Examples :

  Util.formatDuration(Util.roundDuration(38000)); // 38 s
  => 38 s

  Util.formatDuration(Util.roundDuration(76000)); // 1 min 16 s
  => 1 min 16 s

  Util.formatDuration(Util.roundDuration(1564512)); // 26 min 4 s
  => 26 min

  Util.formatDuration(Util.roundDuration(5890000)); // 1 h 38 min 10 s
  => 1 h 38 min

  Util.formatDuration(Util.roundDuration(33165000)); // 9 h 12 min 45 s
  => 9 h

  Util.formatDuration(Util.roundDuration(35025000)); // 9 h 43 min 45 s
  => 10 h

  Util.formatDuration(Util.roundDuration(130993000)); // 1 day 12 h 23 min 13 s
  => 1 day 12 h

  Util.formatDuration(Util.roundDuration(236158000)); // 2 days 17 h 35 min 58 s
  => 2 days 18 h

  Util.formatDuration(Util.roundDuration(731675000)); // 8 days 11 h 14 min 35 s
  => 8 days

  Util.formatDuration(Util.roundDuration(5934547000L)); // 68 days 16 h 29 min 7 s
  => 68 days
 

Parameters:

duration - a duration in milliseconds

Returns:

the duration rounded.

Since:

jcms-6.0.2

formatIso8601Date

public static java.lang.String formatIso8601Date(java.util.Date date)

Returns a date formated with the ISO 8601 Date Time format (eg 1999-01-01T14:07:00+0100).
For more details, see http://en.wikipedia.org/wiki/ISO_8601
This method is thread safe.

Parameters:

date - the date to format.

Returns:

a String with the formated date.

Since:

jcms-5.7.2

See Also:

parseIso8601Date(String)

parseIso8601Date

public static java.util.Date parseIso8601Date(java.lang.String source)

Returns the date parsed from the given string with the ISO 8601 Date Time format (eg 1999-01-01T14:07:00+0100).
For more details, see http://en.wikipedia.org/wiki/ISO_8601
This method is thread safe.

Parameters:

source - the string to be parsed

Returns:

a Date

Since:

jcms-5.7.2

See Also:

formatIso8601Date(Date)

formatW3cDate

public static java.lang.String formatW3cDate(java.util.Date date)

Returns a date formated with the W3C Date Time format (eg 1999-01-01T14:07:00+01:00).
For more details, see http://www.w3.org/TR/NOTE-datetime
This method is thread safe.

Parameters:

date - the date to format.

Returns:

a String with the formated date.

See Also:

parseW3cDate(String)

parseW3cDate

public static java.util.Date parseW3cDate(java.lang.String source)

Returns the date parsed from the given string with the W3C Date Time format (eg 1999-01-01T14:07:00+01:00).
For more details, see http://www.w3.org/TR/NOTE-datetime
This method is thread safe.

Parameters:

source - the string to be parsed

Returns:

a Date

Since:

jcms-5.7.2

See Also:

formatW3cDate(Date)

formatRfc822Date

public static java.lang.String formatRfc822Date(java.util.Date date)

Returns a date formated with the RFC 822 Date Time format (eg Fri, 1 Jan 1999 14:07:00 +0100). For more details, see http://www.w3.org/Protocols/rfc822/rfc822.txt section 5.1
This method is thread safe.

Parameters:

date - the date to format.

Returns:

a String with the formated date.

parseRfc822Date

public static java.util.Date parseRfc822Date(java.lang.String source)

Returns the date parsed from the given string with the RFC 822 Date Time format (eg "Fri, 1 Jan 1999 14:07:00 +0100"). http://www.w3.org/Protocols/rfc822/rfc822.txt section 5.1
This method is thread safe.

Parameters:

source - the string to be parsed

Returns:

a Date

Since:

jcms-5.7.2

formatNoSpaceDate

public static java.lang.String formatNoSpaceDate(java.util.Date date)

Returns a date formated with the following Date Time format: yyyy-MM-dd_hh-mm-ss
This method is thread safe.

Parameters:

date - the date to format.

Returns:

a String with the formated date.

Since:

jcms-5.0.2

parseNoSpaceDate

public static java.util.Date parseNoSpaceDate(java.lang.String source)

Returns the date parsed from the given string with the following Date Time format: yyyy-MM-dd_hh-mm-ss
This method is thread safe.

Parameters:

source - the string to be parsed

Returns:

a Date

Since:

jcms-5.7.2

isToday

public static boolean isToday(java.util.Date date)

Check if a given date is the same day as today (from 0h00 included to 0h00 excluded)

Parameters:

date - the date to check

Returns:

true if the given date is today

isYesterday

public static boolean isYesterday(java.util.Date date)

Check if a given date is the same day as yesterday (from 0h00 included to 0h00 excluded)

Parameters:

date - the date to check

Returns:

true if the given date is yesterday

Since:

jcms-6.0.1

isTomorrow

public static boolean isTomorrow(java.util.Date date)

Check if a given date is the same day as tomorrow (from 0h00 included to 0h00 excluded)

Parameters:

date - the date to check

Returns:

true if the given date is tomorrow

Since:

jcms-6.0.1

isSameDay

public static boolean isSameDay(java.util.Date date1,
                java.util.Date date2)

Check if the 2 given dates are the same day (from 0h00 included to 0h00 excluded)

Parameters:

date1 - the first date to check

date2 - the second date to check

Returns:

true if the given date is today

Since:

jcms-6.0.1

getNewDateWithoutMillis

public static java.util.Date getNewDateWithoutMillis()

Returns the current date with milliseconds reset to 0.

Returns:

the current date with milliseconds reset to 0.

Since:

jcms-6.0.0

rollAndAdd

public static void rollAndAdd(java.util.Calendar calendar,
              int field,
              int amount)

Do a roll on this calendar instance and add or remove one larger field if the roll action return to the boundary of the period Example roll 1 day for 31/12/2010 will give 01/01/2010. This method will return 01/01/2011

Parameters:

calendar - the calendar to update

field - the field to roll

amount - the amount of roll

getDayEndDate

public static java.util.Date getDayEndDate(java.util.Date date,
                           java.util.Locale locale)

Get the date of the end of the day (23h59 59s 999 ms)

Parameters:

date - the date

locale - the Locale used to compute calendar object

Returns:

the end date of the day

getDayStartDate

public static java.util.Date getDayStartDate(java.util.Date date,
                             java.util.Locale locale)

Returns the date corresponding to the day start date of a date

Parameters:

date - the date

locale - the Locale used to compute calendar object

Returns:

the date at 0h00:00 000