DateUtils (jdroid-java 0.7.0 API)

java.lang.Object
- com.jdroid.java.utils.DateUtils

public abstract class DateUtils
extends java.lang.Object

Utilities for Dates and Calendars

Nested Class Summary

Nested Classes
Modifier and Type Class and Description

static class DateUtils.DayOfWeek

Nested Classes
Modifier and Type	Class and Description
`static class`	`DateUtils.DayOfWeek`

Field Summary

Fields
Modifier and Type	Field and Description
`static java.lang.String`	`E_DATE_FORMAT` Date format like Fri
`static java.lang.String`	`EEEE_DATE_FORMAT` Date format like Friday
`static java.lang.String`	`EEEE_MMMD_DATE_FORMAT` Date format like Monday Nov 5
`static java.lang.String`	`EEEE_MMMDYYYY_DATE_FORMAT` Date format like Monday Nov 5 1985
`static java.lang.String`	`EEEEDMMMM_DATE_FORMAT` Date format like Friday 5 November
`static java.lang.String`	`EEEEMMMM_DATE_FORMAT` Date format like Friday November
`static java.lang.String`	`EEMMMDYYYY_DATE_FORMAT` Date format like Sat, Dec 15, 2012
`static java.lang.String`	`EHHMMAA_DATE_FORMAT` Date format like Fri 5:15 AM
`static java.lang.String`	`HHMM_DATE_FORMAT` Date format like 21:45
`static java.lang.String`	`HHMMAA_DATE_FORMAT` Date format like 03:45 PM
`static java.lang.String`	`HHMMSS_DATE_FORMAT` Date format like 21:45:34
`static long`	`MILLIS_PER_DAY` Number of milliseconds in a standard day.
`static long`	`MILLIS_PER_HOUR` Number of milliseconds in a standard hour.
`static long`	`MILLIS_PER_MINUTE` Number of milliseconds in a standard minute.
`static long`	`MILLIS_PER_SECOND` Number of milliseconds in a standard second.
`static java.lang.String`	`MMDDYYYY_DATE_FORMAT` Date format like 10/25/2010
`static java.lang.String`	`MMDDYYYY_SLASH_DATE_FORMAT` Date format like 10-25-2010
`static java.lang.String`	`MMDDYYYYHHMM_DATE_FORMAT` Date format like 10/25/2010 21:30
`static java.lang.String`	`MMMD_DATE_FORMAT` Date format like Nov 5
`static java.lang.String`	`MMMDHHMMAA_DATE_FORMAT` Date format like Nov 5 3:45 PM
`static java.lang.String`	`MMMDYYYY_DATE_FORMAT` Date format like Nov 5 1985
`static java.lang.String`	`MMMDYYYYHHMMAA_DATE_FORMAT` Date format like Nov 5 1985 3:45 PM
`static java.lang.String`	`MMMMD_DATE_FORMAT` Date format like November 5
`static int`	`SECONDS_PER_DAY` Seconds in a day
`static int`	`SECONDS_PER_HOUR` Seconds in an hour
`static int`	`SECONDS_PER_MINUTE` Seconds in a minute
`static int`	`WEEK` Seconds in a week
`static java.lang.String`	`YYYYMMDD_DATE_FORMAT` Date format like 2010-10-25
`static java.lang.String`	`YYYYMMDDHHMMSS_DATE_FORMAT` Date format like 2010-10-25 21:30:00
`static java.lang.String`	`YYYYMMDDHHMMSSSSS_DATE_FORMAT` Date format like 2010-10-25 21:30:00.123
`static java.lang.String`	`YYYYMMDDHHMMSSZ_DATE_FORMAT` Date format like yyyy-MM-dd HH:mm:ss Z
`static java.lang.String`	`YYYYMMDDTHHMMSSZ_DATE_FORMAT` Date format like yyyy-MM-ddTHH:mm:ss Z

Constructor Summary

Constructors
Constructor and Description

DateUtils()

Constructors
Constructor and Description
`DateUtils()`

Method Summary

Methods
Modifier and Type	Method and Description
`static java.util.Date`	`addDays(java.util.Date date, int days)`
`static java.util.Date`	`addMonths(java.util.Date date, int days)`
`static java.util.Date`	`addSeconds(java.util.Date date, int seconds)`
`static java.util.Date`	`addYears(java.util.Date date, int years)`
`static boolean`	`containsPeriod(java.util.Date startDate1, java.util.Date endDate1, java.util.Date startDate2, java.util.Date endDate2)` Returns true if the first period contains the second periods
`static java.lang.String`	`format(java.util.Date date, java.text.DateFormat dateFormat)` Transform the `Date` to a `String` using the received `SimpleDateFormat`
`static java.lang.String`	`format(java.util.Date date, java.lang.String dateFormat)`
`static java.lang.String`	`formatDate(java.util.Date date)`
`static java.lang.String`	`formatDateTime(java.util.Date date)`
`static java.lang.String`	`formatDuration(long duration)`
`static java.lang.String`	`formatTime(java.util.Date date)`
`static java.lang.String`	`formatToCardinal(java.util.Date date)` Transform the `Date` to a `String` with a format like Friday November 5th
`static java.util.Date`	`getDate(java.util.Date date, java.util.Date time)`
`static java.util.Date`	`getDate(java.util.Date date, java.util.Date time, java.lang.Boolean is24Hour)`
`static java.util.Date`	`getDate(int year, int monthOfYear, int dayOfMonth)` Creates a `Date` for the specified day
`static java.util.Date`	`getDate(long milliseconds)`
`static int`	`getDayOfMonth(java.util.Date date)`
`static int`	`getDayOfWeek(java.util.Date date)`
`static int`	`getHour(java.util.Date date, java.lang.Boolean is24Hour)`
`static int`	`getHour(java.util.Date date, java.util.TimeZone timeZone, java.lang.Boolean is24Hour)`
`static java.util.Date`	`getLastDayOfMonth(java.util.Date date)`
`static int`	`getMinute(java.util.Date date)`
`static int`	`getMinute(java.util.Date date, java.util.TimeZone timeZone)`
`static int`	`getMonth(java.util.Date date)`
`static java.util.Date`	`getTime(int hour, int minutes)`
`static java.util.Date`	`getTime(int hour, int minutes, java.lang.Boolean is24Hour)`
`static DateUtils.DayOfWeek`	`getWeekDay()`
`static DateUtils.DayOfWeek`	`getWeekDay(java.util.Date date)`
`static int`	`getYear()`
`static int`	`getYear(java.util.Date date)`
`static void`	`init()`
`static boolean`	`isAfter(java.util.Date date, java.util.Date dateToCompare)` Tests if the date is after than the specified dateToCompare.
`static boolean`	`isAfterEquals(java.util.Date date, java.util.Date dateToCompare)` Tests if the date is after or equals than the specified dateToCompare.
`static boolean`	`isBefore(java.util.Date date, java.util.Date dateToCompare)` Tests if the date is before than the specified dateToCompare.
`static boolean`	`isBeforeEquals(java.util.Date date, java.util.Date dateToCompare)` Tests if the date is before or equals than the specified dateToCompare.
`static boolean`	`isBetween(java.util.Date date, java.util.Date startDate, java.util.Date endDate)`
`static java.util.Date`	`monthsAway(int months)`
`static java.util.Date`	`now()`
`static java.util.Date`	`oneMonthInFuture()`
`static java.util.Date`	`oneMonthInPast()`
`static java.util.Date`	`parse(java.lang.String dateFormatted, java.text.SimpleDateFormat dateFormat)`
`static java.util.Date`	`parse(java.lang.String dateFormatted, java.lang.String dateFormat)`
`static boolean`	`periodsOverlap(java.util.Date startDate1, java.util.Date endDate1, java.util.Date startDate2, java.util.Date endDate2)` Returns true if two periods overlap
`static java.util.Date`	`today()`
`static java.util.Date`	`tomorrow()`
`static void`	`truncate(java.util.Calendar calendar)` Truncate the `Calendar` removing hours, minutes, seconds and milliseconds
`static java.util.Date`	`truncate(java.util.Date date)` Truncate the date removing hours, minutes, seconds and milliseconds
`static java.util.Date`	`yesterday()`

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

- Field Detail
  - SECONDS_PER_MINUTE
```
public static final int SECONDS_PER_MINUTE
```
    Seconds in a minute
    
    See Also:
    Constant Field Values
  - SECONDS_PER_HOUR
```
public static final int SECONDS_PER_HOUR
```
    Seconds in an hour
    
    See Also:
    Constant Field Values
  - SECONDS_PER_DAY
```
public static final int SECONDS_PER_DAY
```
    Seconds in a day
    
    See Also:
    Constant Field Values
  - WEEK
```
public static final int WEEK
```
    Seconds in a week
    
    See Also:
    Constant Field Values
  - MILLIS_PER_SECOND
```
public static final long MILLIS_PER_SECOND
```
    Number of milliseconds in a standard second.
    
    See Also:
    Constant Field Values
  - MILLIS_PER_MINUTE
```
public static final long MILLIS_PER_MINUTE
```
    Number of milliseconds in a standard minute.
    
    See Also:
    Constant Field Values
  - MILLIS_PER_HOUR
```
public static final long MILLIS_PER_HOUR
```
    Number of milliseconds in a standard hour.
    
    See Also:
    Constant Field Values
  - MILLIS_PER_DAY
```
public static final long MILLIS_PER_DAY
```
    Number of milliseconds in a standard day.
    
    See Also:
    Constant Field Values
  - YYYYMMDDTHHMMSSZ_DATE_FORMAT
```
public static final java.lang.String YYYYMMDDTHHMMSSZ_DATE_FORMAT
```
    Date format like yyyy-MM-ddTHH:mm:ss Z
    
    See Also:
    Constant Field Values
  - YYYYMMDDHHMMSSZ_DATE_FORMAT
```
public static final java.lang.String YYYYMMDDHHMMSSZ_DATE_FORMAT
```
    Date format like yyyy-MM-dd HH:mm:ss Z
    
    See Also:
    Constant Field Values
  - YYYYMMDDHHMMSS_DATE_FORMAT
```
public static final java.lang.String YYYYMMDDHHMMSS_DATE_FORMAT
```
    Date format like 2010-10-25 21:30:00
    
    See Also:
    Constant Field Values
  - YYYYMMDDHHMMSSSSS_DATE_FORMAT
```
public static final java.lang.String YYYYMMDDHHMMSSSSS_DATE_FORMAT
```
    Date format like 2010-10-25 21:30:00.123
    
    See Also:
    Constant Field Values
  - MMDDYYYYHHMM_DATE_FORMAT
```
public static final java.lang.String MMDDYYYYHHMM_DATE_FORMAT
```
    Date format like 10/25/2010 21:30
    
    See Also:
    Constant Field Values
  - MMDDYYYY_DATE_FORMAT
```
public static final java.lang.String MMDDYYYY_DATE_FORMAT
```
    Date format like 10/25/2010
    
    See Also:
    Constant Field Values
  - MMDDYYYY_SLASH_DATE_FORMAT
```
public static final java.lang.String MMDDYYYY_SLASH_DATE_FORMAT
```
    Date format like 10-25-2010
    
    See Also:
    Constant Field Values
  - YYYYMMDD_DATE_FORMAT
```
public static final java.lang.String YYYYMMDD_DATE_FORMAT
```
    Date format like 2010-10-25
    
    See Also:
    Constant Field Values
  - EHHMMAA_DATE_FORMAT
```
public static final java.lang.String EHHMMAA_DATE_FORMAT
```
    Date format like Fri 5:15 AM
    
    See Also:
    Constant Field Values
  - E_DATE_FORMAT
```
public static final java.lang.String E_DATE_FORMAT
```
    Date format like Fri
    
    See Also:
    Constant Field Values
  - EEEE_DATE_FORMAT
```
public static final java.lang.String EEEE_DATE_FORMAT
```
    Date format like Friday
    
    See Also:
    Constant Field Values
  - MMMDHHMMAA_DATE_FORMAT
```
public static final java.lang.String MMMDHHMMAA_DATE_FORMAT
```
    Date format like Nov 5 3:45 PM
    
    See Also:
    Constant Field Values
  - MMMDYYYYHHMMAA_DATE_FORMAT
```
public static final java.lang.String MMMDYYYYHHMMAA_DATE_FORMAT
```
    Date format like Nov 5 1985 3:45 PM
    
    See Also:
    Constant Field Values
  - MMMDYYYY_DATE_FORMAT
```
public static final java.lang.String MMMDYYYY_DATE_FORMAT
```
    Date format like Nov 5 1985
    
    See Also:
    Constant Field Values
  - EEEE_MMMDYYYY_DATE_FORMAT
```
public static final java.lang.String EEEE_MMMDYYYY_DATE_FORMAT
```
    Date format like Monday Nov 5 1985
    
    See Also:
    Constant Field Values
  - MMMD_DATE_FORMAT
```
public static final java.lang.String MMMD_DATE_FORMAT
```
    Date format like Nov 5
    
    See Also:
    Constant Field Values
  - EEEE_MMMD_DATE_FORMAT
```
public static final java.lang.String EEEE_MMMD_DATE_FORMAT
```
    Date format like Monday Nov 5
    
    See Also:
    Constant Field Values
  - MMMMD_DATE_FORMAT
```
public static final java.lang.String MMMMD_DATE_FORMAT
```
    Date format like November 5
    
    See Also:
    Constant Field Values
  - HHMMAA_DATE_FORMAT
```
public static final java.lang.String HHMMAA_DATE_FORMAT
```
    Date format like 03:45 PM
    
    See Also:
    Constant Field Values
  - HHMM_DATE_FORMAT
```
public static final java.lang.String HHMM_DATE_FORMAT
```
    Date format like 21:45
    
    See Also:
    Constant Field Values
  - HHMMSS_DATE_FORMAT
```
public static final java.lang.String HHMMSS_DATE_FORMAT
```
    Date format like 21:45:34
    
    See Also:
    Constant Field Values
  - EEEEDMMMM_DATE_FORMAT
```
public static final java.lang.String EEEEDMMMM_DATE_FORMAT
```
    Date format like Friday 5 November
    
    See Also:
    Constant Field Values
  - EEEEMMMM_DATE_FORMAT
```
public static final java.lang.String EEEEMMMM_DATE_FORMAT
```
    Date format like Friday November
    
    See Also:
    Constant Field Values
  - EEMMMDYYYY_DATE_FORMAT
```
public static final java.lang.String EEMMMDYYYY_DATE_FORMAT
```
    Date format like Sat, Dec 15, 2012
    
    See Also:
    Constant Field Values
- Constructor Detail
  - DateUtils
```
public DateUtils()
```
- Method Detail
  - init
```
public static void init()
```
  - parse
```
public static java.util.Date parse(java.lang.String dateFormatted,
                   java.lang.String dateFormat)
```
    Parameters:
    dateFormatted - The formatted string to parse
    dateFormat -
    
    Returns:
    A date that represents the formatted string
  - parse
```
public static java.util.Date parse(java.lang.String dateFormatted,
                   java.text.SimpleDateFormat dateFormat)
```
    Parameters:
    dateFormatted - The formatted string to parse
    dateFormat -
    
    Returns:
    A date that represents the formatted string
  - formatToCardinal
```
public static java.lang.String formatToCardinal(java.util.Date date)
```
    Transform the Date to a String with a format like Friday November 5th
    
    Parameters:
    date - The Date to be formatted
    
    Returns:
    A String that represent the date with the pattern
  - format
```
public static java.lang.String format(java.util.Date date,
                      java.lang.String dateFormat)
```
    Parameters:
    date - The Date to be formatted
    dateFormat - The DateFormat used to format the Date
    
    Returns:
    A String that represent the date with the pattern
  - format
```
public static java.lang.String format(java.util.Date date,
                      java.text.DateFormat dateFormat)
```
    Transform the Date to a String using the received SimpleDateFormat
    
    Parameters:
    date - The Date to be formatted
    dateFormat - The DateFormat used to format the Date
    
    Returns:
    A String that represent the date with the pattern
  - formatDateTime
```
public static java.lang.String formatDateTime(java.util.Date date)
```
  - formatDate
```
public static java.lang.String formatDate(java.util.Date date)
```
  - formatTime
```
public static java.lang.String formatTime(java.util.Date date)
```
  - getDate
```
public static java.util.Date getDate(int year,
                     int monthOfYear,
                     int dayOfMonth)
```
    Creates a Date for the specified day
    
    Parameters:
    year - The year
    monthOfYear - The month number (starting on 0)
    dayOfMonth - The day of the month
    
    Returns:
    The Date
  - getDate
```
public static java.util.Date getDate(java.util.Date date,
                     java.util.Date time,
                     java.lang.Boolean is24Hour)
```
  - getDate
```
public static java.util.Date getDate(java.util.Date date,
                     java.util.Date time)
```
  - getDate
```
public static java.util.Date getDate(long milliseconds)
```
  - getTime
```
public static java.util.Date getTime(int hour,
                     int minutes)
```
  - getTime
```
public static java.util.Date getTime(int hour,
                     int minutes,
                     java.lang.Boolean is24Hour)
```
  - getYear
```
public static int getYear()
```
  - getYear
```
public static int getYear(java.util.Date date)
```
  - getMonth
```
public static int getMonth(java.util.Date date)
```
  - getDayOfMonth
```
public static int getDayOfMonth(java.util.Date date)
```
  - getDayOfWeek
```
public static int getDayOfWeek(java.util.Date date)
```
  - getHour
```
public static int getHour(java.util.Date date,
          java.lang.Boolean is24Hour)
```
  - getHour
```
public static int getHour(java.util.Date date,
          java.util.TimeZone timeZone,
          java.lang.Boolean is24Hour)
```
  - getMinute
```
public static int getMinute(java.util.Date date)
```
  - getMinute
```
public static int getMinute(java.util.Date date,
            java.util.TimeZone timeZone)
```
  - getWeekDay
```
public static DateUtils.DayOfWeek getWeekDay()
```
  - getWeekDay
```
public static DateUtils.DayOfWeek getWeekDay(java.util.Date date)
```
  - addSeconds
```
public static java.util.Date addSeconds(java.util.Date date,
                        int seconds)
```
  - addDays
```
public static java.util.Date addDays(java.util.Date date,
                     int days)
```
  - addMonths
```
public static java.util.Date addMonths(java.util.Date date,
                       int days)
```
  - addYears
```
public static java.util.Date addYears(java.util.Date date,
                      int years)
```
  - truncate
```
public static java.util.Date truncate(java.util.Date date)
```
    Truncate the date removing hours, minutes, seconds and milliseconds
    
    Parameters:
    date - The Date to truncate
    
    Returns:
    The truncated Date
  - truncate
```
public static void truncate(java.util.Calendar calendar)
```
    Truncate the Calendar removing hours, minutes, seconds and milliseconds
    
    Parameters:
    calendar - The Calendar to truncate
  - now
```
public static java.util.Date now()
```
    Returns:
    the current moment
  - isBetween
```
public static boolean isBetween(java.util.Date date,
                java.util.Date startDate,
                java.util.Date endDate)
```
    Parameters:
    date - The date to compare
    startDate - The left between' side
    endDate - The right between's side
    
    Returns:
    true if the date is in the middle of startDate and endDate
  - isBefore
```
public static boolean isBefore(java.util.Date date,
               java.util.Date dateToCompare)
```
    Tests if the date is before than the specified dateToCompare.
    
    Parameters:
    date - the date to compare with the dateToCompare.
    dateToCompare - the date to compare with the date.
    
    Returns:
    true if the instant of time represented by date object is earlier than the instant represented by dateToCompare; false otherwise.
  - isBeforeEquals
```
public static boolean isBeforeEquals(java.util.Date date,
                     java.util.Date dateToCompare)
```
    Tests if the date is before or equals than the specified dateToCompare.
    
    Parameters:
    date - the date to compare with the dateToCompare.
    dateToCompare - the date to compare with the date.
    
    Returns:
    true if the instant of time represented by date object is earlier or equal than the instant represented by dateToCompare; false otherwise.
  - isAfterEquals
```
public static boolean isAfterEquals(java.util.Date date,
                    java.util.Date dateToCompare)
```
    Tests if the date is after or equals than the specified dateToCompare.
    
    Parameters:
    date - the date to compare with the dateToCompare.
    dateToCompare - the date to compare with the date.
    
    Returns:
    true if the instant of time represented by date object is later or equal than the instant represented by dateToCompare; false otherwise.
  - isAfter
```
public static boolean isAfter(java.util.Date date,
              java.util.Date dateToCompare)
```
    Tests if the date is after than the specified dateToCompare.
    
    Parameters:
    date - the date to compare with the dateToCompare.
    dateToCompare - the date to compare with the date.
    
    Returns:
    true if the instant of time represented by date object is later than the instant represented by dateToCompare; false otherwise.
  - periodsOverlap
```
public static boolean periodsOverlap(java.util.Date startDate1,
                     java.util.Date endDate1,
                     java.util.Date startDate2,
                     java.util.Date endDate2)
```
    Returns true if two periods overlap
    
    Parameters:
    startDate1 - the period one start date
    endDate1 - the period one end date
    startDate2 - the period two start date
    endDate2 - the period two end date
    
    Returns:
    true if overlap
  - containsPeriod
```
public static boolean containsPeriod(java.util.Date startDate1,
                     java.util.Date endDate1,
                     java.util.Date startDate2,
                     java.util.Date endDate2)
```
    Returns true if the first period contains the second periods
    
    Parameters:
    startDate1 - the period one start date
    endDate1 - the period one end date
    startDate2 - the period two start date
    endDate2 - the period two end date
    
    Returns:
    true if the first period contains the second period
  - tomorrow
```
public static java.util.Date tomorrow()
```
    Returns:
    a day after today
  - today
```
public static java.util.Date today()
```
  - yesterday
```
public static java.util.Date yesterday()
```
    Returns:
    a day before today
  - monthsAway
```
public static java.util.Date monthsAway(int months)
```
    Parameters:
    months - amount of months to move the calendar
    
    Returns:
    a date that is months in the future/past. Use negative values for past dates.
  - oneMonthInFuture
```
public static java.util.Date oneMonthInFuture()
```
    Returns:
    a date that is one month in the future
  - oneMonthInPast
```
public static java.util.Date oneMonthInPast()
```
    Returns:
    a date that is one month in the past
  - getLastDayOfMonth
```
public static java.util.Date getLastDayOfMonth(java.util.Date date)
```
    Parameters:
    date - Date that includes the desired month in order to calculate the last day of that month
    
    Returns:
    the date of the last day of the month
  - formatDuration
```
public static java.lang.String formatDuration(long duration)
```

Class DateUtils

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

SECONDS_PER_MINUTE

SECONDS_PER_HOUR

SECONDS_PER_DAY

WEEK

MILLIS_PER_SECOND

MILLIS_PER_MINUTE

MILLIS_PER_HOUR

MILLIS_PER_DAY

YYYYMMDDTHHMMSSZ_DATE_FORMAT

YYYYMMDDHHMMSSZ_DATE_FORMAT

YYYYMMDDHHMMSS_DATE_FORMAT

YYYYMMDDHHMMSSSSS_DATE_FORMAT

MMDDYYYYHHMM_DATE_FORMAT

MMDDYYYY_DATE_FORMAT

MMDDYYYY_SLASH_DATE_FORMAT

YYYYMMDD_DATE_FORMAT

EHHMMAA_DATE_FORMAT

E_DATE_FORMAT

EEEE_DATE_FORMAT

MMMDHHMMAA_DATE_FORMAT

MMMDYYYYHHMMAA_DATE_FORMAT

MMMDYYYY_DATE_FORMAT

EEEE_MMMDYYYY_DATE_FORMAT

MMMD_DATE_FORMAT

EEEE_MMMD_DATE_FORMAT

MMMMD_DATE_FORMAT

HHMMAA_DATE_FORMAT

HHMM_DATE_FORMAT

HHMMSS_DATE_FORMAT

EEEEDMMMM_DATE_FORMAT

EEEEMMMM_DATE_FORMAT

EEMMMDYYYY_DATE_FORMAT

Constructor Detail

DateUtils

Method Detail

init

parse

parse

formatToCardinal

format

format

formatDateTime

formatDate

formatTime

getDate

getDate

getDate

getDate

getTime

getTime

getYear

getYear

getMonth

getDayOfMonth

getDayOfWeek

getHour

getHour

getMinute

getMinute

getWeekDay

getWeekDay

addSeconds

addDays

addMonths

addYears

truncate

truncate

now

isBetween

isBefore

isBeforeEquals

isAfterEquals

isAfter