net.obvj.agents.util

Class DateUtils

java.lang.Object

net.obvj.agents.util.DateUtils

public class DateUtils
extends Object

Utility methods for working with dates

Author:

oswaldo.bapvic.jr

Method Summary

Modifier and Type	Method and Description
static String	formatDate(Calendar calendar) Formats the given calendar using a standardized date format.
static String	formatDate(Date date) Formats the given date using a standardized date format.
static String	formatDate(ZonedDateTime zonedDateTime) Formats the given ZonedDateTime using a standardized date format.
static Calendar	getClonedCalendar(Calendar calendar) Creates and returns a clone of the given calendar object.
static Date	getNextExactDateEveryInterval(int interval, TimeUnit timeUnit) Return the next exact date for a given interval and time unit after the current time.
static Date	getNextExactDateEveryInterval(int interval, TimeUnit timeUnit, Calendar calendar) Return the next exact date given a specific interval and time unit after the specified Calendar instance.
static Date	getNextExactDateEveryInterval(int interval, TimeUnit timeUnit, Date date) Return the next exact date given a specific interval and time unit after the specified date.
static ZonedDateTime	now() Returns the current date-time as a ZonedDateTime, using the system clock.

Methods inherited from class java.lang.Object

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

Method Detail

now

public static ZonedDateTime now()

Returns the current date-time as a ZonedDateTime, using the system clock.

Returns:

a ZonedDateTime for the current date-time, not null

formatDate

public static String formatDate(Calendar calendar)

Formats the given calendar using a standardized date format.

Parameters:

calendar - the calendar to be formatted

Returns:

a formatted string

formatDate

public static String formatDate(ZonedDateTime zonedDateTime)

Formats the given ZonedDateTime using a standardized date format.

Parameters:

zonedDateTime - the object to be formatted

Returns:

a formatted string

formatDate

public static String formatDate(Date date)

Formats the given date using a standardized date format.

Parameters:

date - the date to be formatted

Returns:

a formatted string

getNextExactDateEveryInterval

public static Date getNextExactDateEveryInterval(int interval,
                                                 TimeUnit timeUnit)

Return the next exact date for a given interval and time unit after the current time.

For example:

• if current time is 23:38:26 (MM:SS:mi), and the interval is set to 30 seconds, the return will be 23:28:30
• if current time is 23:38:26 (MM:SS:mi), and the interval is set to 1 minute, the return will be 23:39:00
• if current time is 23:38:26 (MM:SS:mi), and the interval is set to 1 hour, the return will be 00:00:00 (next day)

Parameters:

interval - the maximum interval for each execution

timeUnit - the given interval's time unit

Returns:

the next exact date for the given interval and time unit

getNextExactDateEveryInterval

public static Date getNextExactDateEveryInterval(int interval,
                                                 TimeUnit timeUnit,
                                                 Date date)

Return the next exact date given a specific interval and time unit after the specified date.

For example:

• if the source time is 23:38:26 (MM:SS:mi), and the interval is set to 30 seconds, the return will be 23:28:30
• if the source time is 23:38:26 (MM:SS:mi), and the interval is set to 1 minute, the return will be 23:39:00
• if the source time is 23:38:26 (MM:SS:mi), and the interval is set to 1 hour, the return will be 00:00:00 (next day)

Parameters:

interval - the maximum interval for each execution

timeUnit - the given interval's time unit

date - the source Date to be processed

Returns:

the next date for the given interval and time unit

getNextExactDateEveryInterval

public static Date getNextExactDateEveryInterval(int interval,
                                                 TimeUnit timeUnit,
                                                 Calendar calendar)

Return the next exact date given a specific interval and time unit after the specified Calendar instance.

For example:

• if the source time is 23:38:26 (MM:SS:mi), and the interval is set to 30 seconds, the return will be 23:28:30
• if the source time is 23:38:26 (MM:SS:mi), and the interval is set to 1 minute, the return will be 23:39:00
• if the source time is 23:38:26 (MM:SS:mi), and the interval is set to 1 hour, the return will be 00:00:00 (next day)

Parameters:

interval - the maximum interval for each execution

timeUnit - the given interval's time unit

calendar - the source Calendar instance

Returns:

the next date for the given interval and time unit

getClonedCalendar

public static Calendar getClonedCalendar(Calendar calendar)

Creates and returns a clone of the given calendar object.

Parameters:

calendar - the source Calendar

Returns:

a copy of the given calendar instance