public final class

DateUtils

extends Object
java.lang.Object
   ↳ org.apache.http.impl.cookie.DateUtils

Class Overview

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.

Summary

Constants
TimeZone GMT
String PATTERN_ASCTIME Date format pattern used to parse HTTP date headers in ANSI C asctime() format.
String PATTERN_RFC1036 Date format pattern used to parse HTTP date headers in RFC 1036 format.
String PATTERN_RFC1123 Date format pattern used to parse HTTP date headers in RFC 1123 format.
Public Methods
static String formatDate(Date date)
Formats the given date according to the RFC 1123 pattern.
static String formatDate(Date date, String pattern)
Formats the given date according to the specified pattern.
static Date parseDate(String dateValue, String[] dateFormats, Date startDate)
Parses the date value using the given date formats.
static Date parseDate(String dateValue, String[] dateFormats)
Parses the date value using the given date formats.
static Date parseDate(String dateValue)
Parses a date value.
[Expand]
Inherited Methods
From class java.lang.Object

Constants

public static final TimeZone GMT

Since: API Level 1

public static final String PATTERN_ASCTIME

Since: API Level 1

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

Constant Value: "EEE MMM d HH:mm:ss yyyy"

public static final String PATTERN_RFC1036

Since: API Level 1

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

Constant Value: "EEEE, dd-MMM-yy HH:mm:ss zzz"

public static final String PATTERN_RFC1123

Since: API Level 1

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

Constant Value: "EEE, dd MMM yyyy HH:mm:ss zzz"

Public Methods

public static String formatDate (Date date)

Since: API Level 1

Formats the given date according to the RFC 1123 pattern.

Parameters
date The date to format.
Returns
  • An RFC 1123 formatted date string.
See Also

public static String formatDate (Date date, String pattern)

Since: API Level 1

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

public static Date parseDate (String dateValue, String[] dateFormats, Date startDate)

Since: API Level 1

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
DateParseException if none of the dataFormats could parse the dateValue

public static Date parseDate (String dateValue, String[] dateFormats)

Since: API Level 1

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
DateParseException if none of the dataFormats could parse the dateValue

public static Date parseDate (String dateValue)

Since: API Level 1

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
DateParseException if the value could not be parsed using any of the supported date formats