DateUtil (codenameone-core 7.0.94 API)

java.lang.Object
- com.codename1.util.DateUtil

```
public class DateUtil
extends Object
```
Utility class for working with dates and timezones.

Author:

shannah, Diamond

Field Summary

Fields
Modifier and Type	Field and Description
`static long`	`DAY`
`static long`	`HOUR`
`static long`	`MILLISECOND`
`static long`	`MINUTE`
`static long`	`MONTH`
`static long`	`SECOND`
`static long`	`YEAR`

Constructor Summary

Constructors
Constructor and Description

DateUtil()
Creates DateUtil object in default timezone.

DateUtil(TimeZone tz)
Constructor for timezone.

Constructors
Constructor and Description
`DateUtil()` Creates DateUtil object in default timezone.
`DateUtil(TimeZone tz)` Constructor for timezone.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static int`	`compare(Date d1, Date d2)` Compares two dates.
`static Comparator<Date>`	`compareByDateField(long field)` Compares two dates or sorts multiple dates by the granularity of a specific field.
`int`	`getOffset(long date)` Gets the offset from GMT in milliseconds for the given date.
`String`	`getTimeAgo(Date date)` Gets the date in "time ago" format.
`boolean`	`inDaylightTime(Date date)` Checks whether the given date is in daylight savings time for the given date.
`boolean`	`isSameDay(Calendar c1, Calendar c2)` Checks if two times are on the same day using `Calendar`.
`boolean`	`isSameDay(Date d1, Date d2)` Checks if two dates are on the same day in the current timezone.
`boolean`	`isSameHour(Calendar c1, Calendar c2)` Checks if two times are on the same hour using `Calendar`.
`boolean`	`isSameHour(Date d1, Date d2)` Checks if two dates are on the same hour in the current timezone.
`boolean`	`isSameMinute(Calendar c1, Calendar c2)` Checks if two times are on the same minute using `Calendar`.
`boolean`	`isSameMinute(Date d1, Date d2)` Checks if two dates are on the same minute in the current timezone.
`boolean`	`isSameMonth(Calendar c1, Calendar c2)` Checks if two times are on the same month using `Calendar`.
`boolean`	`isSameMonth(Date d1, Date d2)` Checks if two dates are on the same month in the current timezone.
`boolean`	`isSameSecond(Calendar c1, Calendar c2)` Checks if two times are on the same second using `Calendar`.
`boolean`	`isSameSecond(Date d1, Date d2)` Checks if two dates are on the same second in the current timezone.
`boolean`	`isSameTime(Calendar c1, Calendar c2)` Checks if two times are on the same time using `Calendar`.
`boolean`	`isSameTime(Date d1, Date d2)` Checks if two dates are on the same time in the current timezone.
`boolean`	`isSameYear(Calendar c1, Calendar c2)` Checks if two times are on the same year using `Calendar`.
`boolean`	`isSameYear(Date d1, Date d2)` Checks if two dates are on the same year in the current timezone.
`static Date`	`max(Date... dates)` Returns the latest of a set of dates.
`static Date`	`min(Date... dates)` Returns the earliest of a set of dates.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MILLISECOND
```
public static final long MILLISECOND
```
    See Also:
    
    Constant Field Values
  - SECOND
```
public static final long SECOND
```
    See Also:
    
    Constant Field Values
  - MINUTE
```
public static final long MINUTE
```
    See Also:
    
    Constant Field Values
  - HOUR
```
public static final long HOUR
```
    See Also:
    
    Constant Field Values
  - DAY
```
public static final long DAY
```
    See Also:
    
    Constant Field Values
  - MONTH
```
public static final long MONTH
```
    See Also:
    
    Constant Field Values
  - YEAR
```
public static final long YEAR
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - DateUtil
```
public DateUtil(TimeZone tz)
```
    Constructor for timezone.
    
    Parameters:
    
    tz - Timezone
  - DateUtil
```
public DateUtil()
```
    Creates DateUtil object in default timezone.
- Method Detail
  - min
```
public static Date min(Date... dates)
```
    Returns the earliest of a set of dates.
    
    Parameters:
    
    dates -
    
    Returns:
    
    The earliest of a set of dates.
    
    Since:
    
    6.0
  - compare
```
public static int compare(Date d1,
                          Date d2)
```
    Compares two dates.
    
    Parameters:
    
    d1 - A date
    
    d2 - A date
    
    Returns:
    
    -1 if first date is earlier. 1 if first date is later. 0 if they are the same.
    
    Since:
    
    6.0
  - compareByDateField
```
public static Comparator<Date> compareByDateField(long field)
```
    Compares two dates or sorts multiple dates by the granularity of a specific field.
    Compare dates:
    compareByDateField(DateUtil.MONTH).compare(date1, date2)
    
    Sort dates:
    dateList.sort(compareByDateField(DateUtil.MONTH))
    Parameters:
    field - One of the fields:
    
    DateUtil.MILLISECOND
    DateUtil.SECOND
    DateUtil.MINUTE
    DateUtil.HOUR
    DateUtil.DATE
    DateUtil.MONTH
    DateUtil.YEAR
    Returns:
    > 0 - if first date is earlier.
    < 0 - if first date is later.
    == 0 - if they are equal.
    Since:
    
    7.0
  - max
```
public static Date max(Date... dates)
```
    Returns the latest of a set of dates.
    
    Parameters:
    
    dates -
    
    Returns:
    
    The latest of a set of dates.
    
    Since:
    
    6.0
  - getOffset
```
public int getOffset(long date)
```
    Gets the offset from GMT in milliseconds for the given date.
    
    Parameters:
    
    date - The date at which the offset is calculated.
    
    Returns:
    
    Millisecond offset from GMT in the current timezone for the given date.
  - inDaylightTime
```
public boolean inDaylightTime(Date date)
```
    Checks whether the given date is in daylight savings time for the given date.
    
    Parameters:
    
    date - the date to check
    
    Returns:
    
    True if date is in daylight savings time
  - isSameYear
```
public boolean isSameYear(Calendar c1,
                          Calendar c2)
```
    Checks if two times are on the same year using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same year.
    
    Since:
    
    7.0
  - isSameYear
```
public boolean isSameYear(Date d1,
                          Date d2)
```
    Checks if two dates are on the same year in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same year.
    
    Since:
    
    7.0
  - isSameMonth
```
public boolean isSameMonth(Calendar c1,
                           Calendar c2)
```
    Checks if two times are on the same month using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same month.
    
    Since:
    
    7.0
  - isSameMonth
```
public boolean isSameMonth(Date d1,
                           Date d2)
```
    Checks if two dates are on the same month in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same month.
    
    Since:
    
    7.0
  - isSameDay
```
public boolean isSameDay(Calendar c1,
                         Calendar c2)
```
    Checks if two times are on the same day using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same day.
    
    Since:
    
    7.0
  - isSameDay
```
public boolean isSameDay(Date d1,
                         Date d2)
```
    Checks if two dates are on the same day in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same day.
    
    Since:
    
    7.0
  - isSameHour
```
public boolean isSameHour(Calendar c1,
                          Calendar c2)
```
    Checks if two times are on the same hour using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same hour.
    
    Since:
    
    7.0
  - isSameHour
```
public boolean isSameHour(Date d1,
                          Date d2)
```
    Checks if two dates are on the same hour in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same hour.
    
    Since:
    
    7.0
  - isSameMinute
```
public boolean isSameMinute(Calendar c1,
                            Calendar c2)
```
    Checks if two times are on the same minute using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same minute.
    
    Since:
    
    7.0
  - isSameMinute
```
public boolean isSameMinute(Date d1,
                            Date d2)
```
    Checks if two dates are on the same minute in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same minute.
    
    Since:
    
    7.0
  - isSameSecond
```
public boolean isSameSecond(Calendar c1,
                            Calendar c2)
```
    Checks if two times are on the same second using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same second.
    
    Since:
    
    7.0
  - isSameSecond
```
public boolean isSameSecond(Date d1,
                            Date d2)
```
    Checks if two dates are on the same second in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same second.
    
    Since:
    
    7.0
  - isSameTime
```
public boolean isSameTime(Calendar c1,
                          Calendar c2)
```
    Checks if two times are on the same time using Calendar.
    
    Parameters:
    
    c1 - First time to compare.
    
    c2 - Second time to compare.
    
    Returns:
    
    True if the two times are on the same time.
    
    Since:
    
    7.0
  - isSameTime
```
public boolean isSameTime(Date d1,
                          Date d2)
```
    Checks if two dates are on the same time in the current timezone.
    
    Parameters:
    
    d1 - First date to compare.
    
    d2 - Second date to compare.
    
    Returns:
    
    True if the two dates are on the same time.
    
    Since:
    
    7.0
  - getTimeAgo
```
public String getTimeAgo(Date date)
```
    Gets the date in "time ago" format. E.g. "Just now", or "1 day ago", etc..
    
    Parameters:
    
    date - The date
    
    Returns:
    
    String representing how long ago from now the given date is.
    
    Since:
    
    6.0

Class DateUtil

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MILLISECOND

SECOND

MINUTE

HOUR

DAY

MONTH

YEAR

Constructor Detail

DateUtil

DateUtil

Method Detail

min

compare

compareByDateField

max

getOffset

inDaylightTime

isSameYear

isSameYear

isSameMonth

isSameMonth

isSameDay

isSameDay

isSameHour

isSameHour

isSameMinute

isSameMinute

isSameSecond

isSameSecond

isSameTime

isSameTime

getTimeAgo