DateUtils (JEP Data Extension 1.0.3 API)

java.lang.Object
- net.obvj.jep.util.DateUtils

```
public class DateUtils
extends Object
```
A utility class for working with dates.

Author:

oswaldo.bapvic.jr

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static boolean`	`containsParsableDates(Iterable<?> iterable)` Checks if all the elements are parsable dates.
`static boolean`	`containsParsableDatesIso8601(Iterable<?> iterable)` Checks if all the elements are parsable dates.
`static boolean`	`containsParsableDatesRfc3339(Iterable<?> iterable)` Checks if all the elements are parsable dates.
`static long`	`daysBetween(Date firstDate, Date secondDate)` Calculates the number of days between two dates
`static Date`	`endOfMonth(Date date)` Returns the date corresponding to the last day of the month given a source date
`static String`	`formatDate(Date date, String pattern)` Converts the given date into string with the the given `pattern`
`static int`	`getDateField(Date date, int calendarCode)` Returns the field referenced by the given `calendarCode` in the specified date.
`static int`	`getIsoWeekNumber(Date date)` Returns the ISO week number in the year given a date.
`static int`	`getMonth(Date date)` Returns the month number (January = 1) for the given date.
`static int`	`getQuarter(Date date)` Returns the quarter of the year.
`static boolean`	`isLeapYear(Date date)` Returns true if the given date is a leap year, that is, an year with 366 days, the extra day designated as February 29.
`static boolean`	`isLeapYear(int year)` Returns true if the given year is a leap year, that is, an year with 366 days, the extra day designated as February 29.
`static boolean`	`isParsable(Object object)` Checks whether the given object can be a valid date.
`static boolean`	`isParsableIso8601(String string)` Checks whether the given string can be a valid date based on a set of common ISO-8601 format variations.
`static boolean`	`isParsableRfc3339(String string)` Checks whether the given string can be a valid date in RFC-3339 format.
`static Date`	`parseDate(Object object)` Converts the given object into `Date`.
`static Date`	`parseDate(String string, String... patterns)` Converts the given string into `Date` by applying the specified patterns until the operation succeeds
`static Date`	`parseDateIso8601(String string)` Converts the given string into `Date` by trying a set of common ISO-8601 parse patterns.
`static Date`	`parseDateRfc3339(String string)` Converts the given string into `Date` based in RFC-3339 format.
`static Calendar`	`toCalendar(Date date)` Converts a date to Calendar

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

- Method Detail
  - formatDate
```
public static String formatDate(Date date,
                                String pattern)
```
    Converts the given date into string with the the given pattern
    
    Parameters:
    
    date - the date to be formatted
    
    pattern - the date format pattern to be used
    
    Returns:
    
    the string converted to Date
  - parseDate
```
public static Date parseDate(String string,
                             String... patterns)
                      throws ParseException
```
    Converts the given string into Date by applying the specified patterns until the operation succeeds
    
    Parameters:
    
    string - the string to be converted
    
    patterns - the date format patterns to be used
    
    Returns:
    
    the parsed date
    
    Throws:
    
    IllegalArgumentException - if a null string or pattern is received
    
    ParseException - if the date can not be parsed
  - parseDateRfc3339
```
public static Date parseDateRfc3339(String string)
```
    Converts the given string into Date based in RFC-3339 format.
    
    Parameters:
    
    string - the string to be converted
    
    Returns:
    
    the parsed date
    
    Throws:
    
    IllegalArgumentException - if the date can not be parsed
  - parseDateIso8601
```
public static Date parseDateIso8601(String string)
```
    Converts the given string into Date by trying a set of common ISO-8601 parse patterns.
    
    Parameters:
    
    string - the string to be converted
    
    Returns:
    
    the parsed date
    
    Throws:
    
    IllegalArgumentException - if the date cannot be parsed
  - parseDate
```
public static Date parseDate(Object object)
```
    Converts the given object into Date. It supports objects of type Instant, and valid strings in RFC-3339 format and other common ISO-8601 format variations.
    
    Parameters:
    
    object - the object to be converted
    
    Returns:
    
    the parsed date
    
    Throws:
    
    IllegalArgumentException - if the date can not be p'varsed
  - isParsable
```
public static boolean isParsable(Object object)
```
    Checks whether the given object can be a valid date. Strings will be checked against RFC-3339 format or a set of common ISO-8601 format variations.
    
    Parameters:
    
    object - the object to be evaluated
    
    Returns:
    
    true if the object is either a Date, an Instant, or a valid String representation in either RFC-3339 or a set of common ISO-8601 format
  - isParsableRfc3339
```
public static boolean isParsableRfc3339(String string)
```
    Checks whether the given string can be a valid date in RFC-3339 format.
    
    Parameters:
    
    string - the object to be evaluated
    
    Returns:
    
    true if the string is a valid date representation in RFC-3339 format
  - isParsableIso8601
```
public static boolean isParsableIso8601(String string)
```
    Checks whether the given string can be a valid date based on a set of common ISO-8601 format variations.
    
    Parameters:
    
    string - the string to be evaluated
    
    Returns:
    
    true if the string is a valid date representation in ISO-8601 format
  - containsParsableDates
```
public static boolean containsParsableDates(Iterable<?> iterable)
```
    Checks if all the elements are parsable dates. Valid element types may be any of the following: Date, Instant or Strings in RFC-3339 or a set of commonly-used ISO-8601 format variations.
    
    Parameters:
    
    iterable - the iterable to be evaluated
    
    Returns:
    
    true if all elements are parsable to date
  - containsParsableDatesRfc3339
```
public static boolean containsParsableDatesRfc3339(Iterable<?> iterable)
```
    Checks if all the elements are parsable dates. Strings will be checked in RFC-3339 format.
    
    Parameters:
    
    iterable - the iterable whose elements will be evaluated
    
    Returns:
    
    true if all elements are parsable to date
  - containsParsableDatesIso8601
```
public static boolean containsParsableDatesIso8601(Iterable<?> iterable)
```
    Checks if all the elements are parsable dates. Strings will be checked against a set of common ISO-8601 format variations.
    
    Parameters:
    
    iterable - the iterable whose elements will be evaluated
    
    Returns:
    
    true if all elements are parsable to date
  - toCalendar
```
public static Calendar toCalendar(Date date)
```
    Converts a date to Calendar
    
    Parameters:
    
    date - the Date to be converted
    
    Returns:
    
    a Calendar with the given date set
  - daysBetween
```
public static long daysBetween(Date firstDate,
                               Date secondDate)
```
    Calculates the number of days between two dates
    
    Parameters:
    
    firstDate - the first date for the comparison
    
    secondDate - the seconds date for the comparison
    
    Returns:
    
    the number of days between firstDate and secondDate
    
    Throws:
    
    IllegalArgumentException - if a null date is received
  - isLeapYear
```
public static boolean isLeapYear(Date date)
```
    Returns true if the given date is a leap year, that is, an year with 366 days, the extra day designated as February 29.
    
    Parameters:
    
    date - the date whose year is to be evaluated
    
    Returns:
    
    true if the given year is leap year, false if not.
    
    Throws:
    
    IllegalArgumentException - if a null date is received
  - isLeapYear
```
public static boolean isLeapYear(int year)
```
    Returns true if the given year is a leap year, that is, an year with 366 days, the extra day designated as February 29.
    
    Parameters:
    
    year - the year to be evaluated
    
    Returns:
    
    true if the given year is leap year, false if not.
  - getIsoWeekNumber
```
public static int getIsoWeekNumber(Date date)
```
    Returns the ISO week number in the year given a date.
    According to the standard, the first week of the year will be the first one with a minimum of 4 days, starting with Monday.
    
    Parameters:
    
    date - the date to be accepted
    
    Returns:
    
    the week number in the year for the given date
  - getMonth
```
public static int getMonth(Date date)
```
    Returns the month number (January = 1) for the given date.
    
    Parameters:
    
    date - the date whose month number is to be retrieved
    
    Returns:
    
    the month number for the given date
  - getQuarter
```
public static int getQuarter(Date date)
```
    Returns the quarter of the year.
    
    Parameters:
    
    date - the date whose quarter is to be retrieved
    
    Returns:
    
    the quarter of the year for the given date
  - getDateField
```
public static int getDateField(Date date,
                               int calendarCode)
```
    Returns the field referenced by the given calendarCode in the specified date.
    
    Parameters:
    
    date - the date whose field is to be retrieved
    
    calendarCode - one of the integer constants from Calendar
    
    Returns:
    
    the field referenced by the given calendarCode in the specified date
  - endOfMonth
```
public static Date endOfMonth(Date date)
```
    Returns the date corresponding to the last day of the month given a source date
    
    Parameters:
    
    date - the date to be converted
    
    Returns:
    
    the date corresponding to the last day of the month

Class DateUtils

Method Summary

Methods inherited from class java.lang.Object

Method Detail

formatDate

parseDate

parseDateRfc3339

parseDateIso8601

parseDate

isParsable

isParsableRfc3339

isParsableIso8601

containsParsableDates

containsParsableDatesRfc3339

containsParsableDatesIso8601

toCalendar

daysBetween

isLeapYear

isLeapYear

getIsoWeekNumber

getMonth

getQuarter

getDateField

endOfMonth