public class DateUtil extends Object
DateUtil
is a utility class that provides easy access to
commonly used dates and for parsing/reading ISO8601 date strings.Constructor and Description |
---|
DateUtil()
Initializes a DateUtil with the first day of week being the Monday.
|
DateUtil(int firstDayOfWeek)
Initializes a DateUtil with a custom first day of the week.
|
Modifier and Type | Method and Description |
---|---|
static DateFormat |
getDateFormat(String pattern,
DateFormat defaultDateFormat,
Locale locale)
Returns a date format object, based on either a custom date pattern or a default date pattern, and a
Locale |
static DateFormat |
getDateFormat(String pattern,
Locale locale)
Returns a date format object, based on a date pattern and a
Locale |
static DateFormat |
getDateFormat(String pattern,
String defaultPattern,
Locale locale)
Returns a date format object, based on either a custom date pattern or a default date pattern, and a
Locale |
static String |
getISO8601Date(Calendar calendar)
Generate a full ISO 8601 date: "YYYY-MM-DDTHH:mm:ss.SSSZ".
|
static String |
getISO8601Date(Date date)
Generate a full ISO 8601 date: "YYYY-MM-DDTHH:mm:ss.SSSZ".
|
static String |
getISO8601Date(Date date,
TimeZone timeZone)
Generate a full ISO 8601 date: "YYYY-MM-DDTHH:mm:ss.SSSZ".
|
static String |
getISO8601DateAndTimeNoMillis(Calendar calendar)
Generate a ISO 8601 date with date and time, but without the milliseconds
part: "YYYY-MM-DDTHH:mm:ssZ".
|
static String |
getISO8601DateAndTimeNoMillis(Date date)
Generate a ISO 8601 date with date and time, but without the milliseconds
part: "YYYY-MM-DDTHH:mm:ssZ".
|
static String |
getISO8601DateAndTimeNoMillis(Date date,
TimeZone timeZone)
Generate a ISO 8601 date with date and time, but without the milliseconds
part: "YYYY-MM-DDTHH:mm:ssZ".
|
static String |
getISO8601DateNoTime(Calendar calendar)
Generate a ISO 8601 date in the pure date form: "YYYY-MM-DD"
|
static String |
getISO8601DateNoTime(Date date)
Generate a ISO 8601 date in the pure date form: "YYYY-MM-DD".
|
static String |
getISO8601DateNoTime(Date date,
TimeZone timeZone)
Generate a ISO 8601 date in the pure date form: "YYYY-MM-DD".
|
Calendar |
getLastYearStart() |
Calendar |
getMonthStart() |
Calendar |
getNow() |
Calendar |
getThreeMonthsAgo() |
Calendar |
getToday() |
Calendar |
getWeekStart() |
Calendar |
getYearStart() |
static Calendar |
parseISO8601(String iso8601Date)
Parse the given string in ISO 8601 format and build a Calendar object.
|
static Calendar |
parseISO8601(String iso8601Date,
TimeZone defaultTimeZone)
Parse the given string in ISO 8601 format and build a Calendar object.
|
public DateUtil()
public DateUtil(int firstDayOfWeek)
firstDayOfWeek
- the first day of the week.Calendar.DAY_OF_WEEK
public final Calendar getLastYearStart()
public final Calendar getYearStart()
public final Calendar getThreeMonthsAgo()
public final Calendar getMonthStart()
public final Calendar getWeekStart()
Calendar.setFirstDayOfWeek(int)
!public final Calendar getToday()
public final Calendar getNow()
public static Calendar parseISO8601(String iso8601Date) throws InvalidDateException
iso8601Date
- the date in ISO 8601 formatInvalidDateException
- if the date string is not validpublic static Calendar parseISO8601(String iso8601Date, TimeZone defaultTimeZone) throws InvalidDateException
iso8601Date
- the date in ISO 8601 formatdefaultTimeZone
- the timezone to use when the timezone is not specified in the
iso-8601 string (if null
, the system default timezone will be used)InvalidDateException
- if the date string is not validpublic static String getISO8601Date(Calendar calendar)
calendar
- a Calendar instancepublic static String getISO8601Date(Date date)
date
- a Date instance representing a UTC timepublic static String getISO8601Date(Date date, TimeZone timeZone)
date
- a Date instancetimeZone
- the timeZone of the datepublic static String getISO8601DateAndTimeNoMillis(Calendar calendar)
calendar
- a Calendar instancepublic static String getISO8601DateAndTimeNoMillis(Date date)
date
- a Date instance representing a UTC timepublic static String getISO8601DateAndTimeNoMillis(Date date, TimeZone timeZone)
date
- a Date instancetimeZone
- the timeZone of the datepublic static String getISO8601DateNoTime(Calendar calendar)
calendar
- a Calendar instancepublic static String getISO8601DateNoTime(Date date)
date
- a Date instance representing a UTC time.public static String getISO8601DateNoTime(Date date, TimeZone timeZone)
date
- a Date instance representing a datetimeZone
- the timeZone of the datepublic static DateFormat getDateFormat(String pattern, Locale locale)
Locale
pattern
- Date patternlocale
- Date format localisationnull
public static DateFormat getDateFormat(String pattern, String defaultPattern, Locale locale)
Locale
pattern
- User provided date patterndefaultPattern
- Default date format used if the user provided date pattern was not validlocale
- Date format localisationpublic static DateFormat getDateFormat(String pattern, DateFormat defaultDateFormat, Locale locale)
Locale
pattern
- User provided date patterndefaultDateFormat
- Default date format used if the user provided date pattern was not validlocale
- Date format localisationCopyright © 2010 - 2020 Adobe. All Rights Reserved