Package io.milton.http

Class DateUtils

java.lang.Object

io.milton.http.DateUtils

public class DateUtils
extends Object

A utility class for parsing and formatting HTTP dates as used in cookies and other headers. This class handles dates as defined by RFC 2616 section 3.3.1 as well as some other common non-standard formats.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DateUtils.DateParseException

Field Summary

Fields

Modifier and Type	Field	Description
static final TimeZone	GMT
static final String	PATTERN_ASCTIME	Date format pattern used to parse HTTP date headers in ANSI C asctime() format.
static final String	PATTERN_ASCTIME2	Another Date format pattern used to parse HTTP date headers in ANSI C asctime() format.
static final String	PATTERN_RESPONSE_HEADER	Used for response headers, and for modified date in propfind
static final String	PATTERN_RFC1036	Date format pattern used to parse HTTP date headers in RFC 1036 format.
static final String	PATTERN_RFC1123	Date format pattern used to parse HTTP date headers in RFC 1123 format.
static final String	PATTERN_RFC1123_HYPHENS	Like PATTERN_RFC1123 but with hyphens between the date components
static final String	PATTERN_RFC1123_NOSECS	Date format pattern used to parse HTTP date headers in RFC 1123 format.
static final String	PATTERN_WEBDAV

Method Summary

Modifier and Type	Method	Description
static String	formatDate(Calendar cal)
static String	formatDate(Date date)
static String	formatDate(Date date, String pattern)	Formats the given date according to the specified pattern.
static String	formatForCookieExpiry(Date date)
static String	formatForHeader(Date date)
static String	formatForWebDavModifiedDate(Date date)	Use the long date form required for MS windows explorer
static String	pad2(int i)
static Date	parseDate(String dateValue)	Parses a date value.
static Date	parseDate(String dateValue, Collection<String> dateFormats)	Parses the date value using the given date formats.
static Date	parseDate(String dateValue, Collection<String> dateFormats, Date startDate)	Parses the date value using the given date formats.
static Date	parseIcalDateTime(String s)	20140104T050000Z 20131222T000000Z
static Date	parseIcalDateTime_old(String s)
static Date	parseWebDavDate(String s)	Parse date in format: 2010-09-03T09:29:43Z

Methods inherited from class java.lang.Object

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

Field Details

PATTERN_WEBDAV

public static final String PATTERN_WEBDAV

See Also:

• Constant Field Values

PATTERN_RESPONSE_HEADER

public static final String PATTERN_RESPONSE_HEADER

Used for response headers, and for modified date in propfind

See Also:

• Constant Field Values

PATTERN_RFC1123

public static final String PATTERN_RFC1123

Date format pattern used to parse HTTP date headers in RFC 1123 format.

See Also:

• Constant Field Values

PATTERN_RFC1123_HYPHENS

public static final String PATTERN_RFC1123_HYPHENS

Like PATTERN_RFC1123 but with hyphens between the date components

See Also:

• Constant Field Values

PATTERN_RFC1123_NOSECS

public static final String PATTERN_RFC1123_NOSECS

Date format pattern used to parse HTTP date headers in RFC 1123 format.

See Also:

• Constant Field Values

PATTERN_RFC1036

public static final String PATTERN_RFC1036

Date format pattern used to parse HTTP date headers in RFC 1036 format.

See Also:

• Constant Field Values

PATTERN_ASCTIME

public static final String PATTERN_ASCTIME

Date format pattern used to parse HTTP date headers in ANSI C asctime() format.

See Also:

• Constant Field Values

PATTERN_ASCTIME2

public static final String PATTERN_ASCTIME2

Another Date format pattern used to parse HTTP date headers in ANSI C asctime() format.

See Also:

• Constant Field Values

GMT

public static final TimeZone GMT

Method Details

parseWebDavDate

public static Date parseWebDavDate(String s)
                            throws DateUtils.DateParseException

Parse date in format: 2010-09-03T09:29:43Z

Parameters:

s -

Returns:

Throws:

DateUtils.DateParseException

parseIcalDateTime

public static Date parseIcalDateTime(String s)
                              throws DateUtils.DateParseException

20140104T050000Z 20131222T000000Z

Parameters:

s -

Returns:

Throws:

DateUtils.DateParseException

parseIcalDateTime_old

public static Date parseIcalDateTime_old(String s)
                                  throws DateUtils.DateParseException

Throws:

DateUtils.DateParseException

parseDate

public static Date parseDate(String dateValue)
                      throws DateUtils.DateParseException

Parses a date value. The formats used for parsing the date value are retrieved from the default http params.

Parameters:

dateValue - the date value to parse

Returns:

the parsed date

Throws:

DateUtils.DateParseException - if the value could not be parsed using any of the supported date formats

parseDate

public static Date parseDate(String dateValue,
 Collection<String> dateFormats)
                      throws DateUtils.DateParseException

Parses the date value using the given date formats.

Parameters:

dateValue - the date value to parse

dateFormats - the date formats to use

Returns:

the parsed date

Throws:

DateUtils.DateParseException - if none of the dataFormats could parse the dateValue

parseDate

public static Date parseDate(String dateValue,
 Collection<String> dateFormats,
 Date startDate)
                      throws DateUtils.DateParseException

Parses the date value using the given date formats.

Parameters:

dateValue - the date value to parse

dateFormats - the date formats to use

startDate - During parsing, two digit years will be placed in the range startDate to startDate + 100 years. This value may be null. When null is given as a parameter, year 2000 will be used.

Returns:

the parsed date

Throws:

DateUtils.DateParseException - if none of the dataFormats could parse the dateValue

formatDate

public static String formatDate(Date date)

formatDate

public static String formatDate(Calendar cal)

Parameters:

cal -

Returns:

See Also:

• PATTERN_WEBDAV

formatForHeader

public static String formatForHeader(Date date)

pad2

public static String pad2(int i)

formatDate

public static String formatDate(Date date,
 String pattern)

Formats the given date according to the specified pattern. The pattern must conform to that used by the simple date format class.

Parameters:

date - The date to format.

pattern - The pattern to use for formatting the date.

Returns:

A formatted date string.

Throws:

IllegalArgumentException - If the given date pattern is invalid.

See Also:

• SimpleDateFormat

formatForWebDavModifiedDate

public static String formatForWebDavModifiedDate(Date date)

Use the long date form required for MS windows explorer

Parameters:

date -

Returns:

formatForCookieExpiry

public static String formatForCookieExpiry(Date date)