org.kocakosm.pitaya.time

Class Dates

java.lang.Object

org.kocakosm.pitaya.time.Dates

public final class Dates
extends Object

Dates utilities.

Author:

Osman KOCAK

Method Summary

Methods

Modifier and Type	Method and Description
static Date	copy(Date date) Returns a copy of the given Date.
static String	format(Date date, String format) Returns the String representation of the given Date according to the specified format pattern.
static boolean	isSameDay(Calendar cal1, Calendar cal2) Returns whether the given Calendars represent the same day.
static boolean	isSameDay(Date date1, Date date2) Returns whether the given Dates represent the same day.
static boolean	isSameInstant(Calendar cal1, Calendar cal2) Returns whether the given Calendars represent the same instant.
static boolean	isSameInstant(Date date1, Date date2) Returns whether the given Dates represent the same instant.
static boolean	isSameLocalTime(Calendar cal1, Calendar cal2) Returns whether the given Calendars represent the same local time.
static boolean	isSameLocalTime(Date date1, Date date2) Returns whether the given Dates represent the same local time.
static boolean	isSameMonth(Calendar cal1, Calendar cal2) Returns whether the given Calendars represent the same month.
static boolean	isSameMonth(Date date1, Date date2) Returns whether the given Dates represent the same month.
static boolean	isSameWeek(Calendar cal1, Calendar cal2) Returns whether the given Calendars represent the same week.
static boolean	isSameWeek(Date date1, Date date2) Returns whether the given Dates represent the same week.
static boolean	isSameYear(Calendar cal1, Calendar cal2) Returns whether the given Calendars represent the same year.
static boolean	isSameYear(Date date1, Date date2) Returns whether the given Dates represent the same year.
static Date	now() Returns a new Date representing the current instant.
static Date	parse(String date, Locale locale, String... formats) Parses a String representing a date into a Date instance.
static Date	parse(String date, String... formats) Parses a String representing a date into a Date instance.
static Calendar	toCalendar(Date date) Converts a Date into a Calendar.

Methods inherited from class java.lang.Object

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

Method Detail

copy

public static Date copy(Date date)

Returns a copy of the given Date.

Parameters:

date - the Date to copy.

Returns:

a copy of the given Date or null if it was null.

now

public static Date now()

Returns a new Date representing the current instant.

Returns:

a new Date representing the current instant.

isSameInstant

public static boolean isSameInstant(Date date1,
                    Date date2)

Returns whether the given Dates represent the same instant.

Parameters:

date1 - the first Date.

date2 - the second Date.

Returns:

whether the given Dates represent the same instant.

Throws:

NullPointerException - if one of the arguments is null.

isSameInstant

public static boolean isSameInstant(Calendar cal1,
                    Calendar cal2)

Returns whether the given Calendars represent the same instant.

Parameters:

cal1 - the first Calendar.

cal2 - the second Calendar.

Returns:

whether the given Calendars represent the same instant.

Throws:

NullPointerException - if one of the arguments is null.

isSameLocalTime

public static boolean isSameLocalTime(Date date1,
                      Date date2)

Returns whether the given Dates represent the same local time.

Parameters:

date1 - the first Date.

date2 - the second Date.

Returns:

whether the given Dates represent the same local time.

Throws:

NullPointerException - if one of the arguments is null.

isSameLocalTime

public static boolean isSameLocalTime(Calendar cal1,
                      Calendar cal2)

Returns whether the given Calendars represent the same local time.

Parameters:

cal1 - the first Calendar.

cal2 - the second Calendar.

Returns:

whether the given Calendars represent the same local time.

Throws:

NullPointerException - if one of the arguments is null.

isSameDay

public static boolean isSameDay(Date date1,
                Date date2)

Returns whether the given Dates represent the same day.

Parameters:

date1 - the first Date.

date2 - the second Date.

Returns:

whether the given Dates represent the same day.

Throws:

NullPointerException - if one of the arguments is null.

isSameDay

public static boolean isSameDay(Calendar cal1,
                Calendar cal2)

Returns whether the given Calendars represent the same day.

Parameters:

cal1 - the first Calendar.

cal2 - the second Calendar.

Returns:

whether the given Calendars represent the same day.

Throws:

NullPointerException - if one of the arguments is null.

isSameWeek

public static boolean isSameWeek(Date date1,
                 Date date2)

Returns whether the given Dates represent the same week.

Parameters:

date1 - the first Date.

date2 - the second Date.

Returns:

whether the given Dates represent the same week.

Throws:

NullPointerException - if one of the arguments is null.

isSameWeek

public static boolean isSameWeek(Calendar cal1,
                 Calendar cal2)

Returns whether the given Calendars represent the same week.

Parameters:

cal1 - the first Calendar.

cal2 - the second Calendar.

Returns:

whether the given Calendars represent the same week.

Throws:

NullPointerException - if one of the arguments is null.

isSameMonth

public static boolean isSameMonth(Date date1,
                  Date date2)

Returns whether the given Dates represent the same month.

Parameters:

date1 - the first Date.

date2 - the second Date.

Returns:

whether the given Dates represent the same month.

Throws:

NullPointerException - if one of the arguments is null.

isSameMonth

public static boolean isSameMonth(Calendar cal1,
                  Calendar cal2)

Returns whether the given Calendars represent the same month.

Parameters:

cal1 - the first Calendar.

cal2 - the second Calendar.

Returns:

whether the given Calendars represent the same month.

Throws:

NullPointerException - if one of the arguments is null.

isSameYear

public static boolean isSameYear(Date date1,
                 Date date2)

Returns whether the given Dates represent the same year.

Parameters:

date1 - the first Date.

date2 - the second Date.

Returns:

whether the given Dates represent the same year.

Throws:

NullPointerException - if one of the arguments is null.

isSameYear

public static boolean isSameYear(Calendar cal1,
                 Calendar cal2)

Returns whether the given Calendars represent the same year.

Parameters:

cal1 - the first Calendar.

cal2 - the second Calendar.

Returns:

whether the given Calendars represent the same year.

Throws:

NullPointerException - if one of the arguments is null.

parse

public static Date parse(String date,
         String... formats)

Parses a String representing a date into a Date instance. The given formats will be used sequentially until a successful parsing is obtained. A parsing is considered successful if it parses the whole input String.

Parameters:

date - the String to parse.

formats - the date format patterns to use.

Returns:

the parsed Date.

Throws:

NullPointerException - if one of the arguments is null or if formats contains a null reference.

IllegalArgumentException - if formats is empty or if date can't be parsed with any of the specified formats.

parse

public static Date parse(String date,
         Locale locale,
         String... formats)

Parses a String representing a date into a Date instance. The given formats will be used sequentially until a successful parsing is obtained. A parsing is considered successful if it parses the whole input String.

Parameters:

date - the String to parse.

locale - the Locale to use.

formats - the date format patterns to use.

Returns:

the parsed Date.

Throws:

NullPointerException - if one of the arguments is null or if formats contains a null reference.

IllegalArgumentException - if formats is empty or if date can't be parsed with any of the specified formats.

format

public static String format(Date date,
            String format)

Returns the String representation of the given Date according to the specified format pattern.

Parameters:

date - the Date to format.

format - the format pattern to use.

Returns:

the String representation of date.

Throws:

NullPointerException - if one of the arguments is null.

toCalendar

public static Calendar toCalendar(Date date)

Converts a Date into a Calendar.

Parameters:

date - the Date to convert to a Calendar.

Returns:

the created Calendar instance.

Throws:

NullPointerException - if date is null.