org.apache.commons.httpclient.util
Class DateUtil
java.lang.Object
org.apache.commons.httpclient.util.DateUtil
public class DateUtil
extends java.lang.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.
- Christopher Brown
- Michael Becke
static String | PATTERN_ASCTIME - Date format pattern used to parse HTTP date headers in ANSI C
asctime() format.
|
static String | PATTERN_RFC1036 - Date format pattern used to parse HTTP date headers in RFC 1036 format.
|
static String | PATTERN_RFC1123 - Date format pattern used to parse HTTP date headers in RFC 1123 format.
|
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) - Parses a date value.
|
static Date | parseDate(String dateValue, Collection dateFormats) - Parses the date value using the given date formats.
|
static Date | parseDate(String dateValue, Collection dateFormats, Date startDate) - Parses the date value using the given date formats.
|
PATTERN_ASCTIME
public static final String PATTERN_ASCTIME
Date format pattern used to parse HTTP date headers in ANSI C
asctime()
format.
PATTERN_RFC1036
public static final String PATTERN_RFC1036
Date format pattern used to parse HTTP date headers in RFC 1036 format.
PATTERN_RFC1123
public static final String PATTERN_RFC1123
Date format pattern used to parse HTTP date headers in RFC 1123 format.
formatDate
public static String formatDate(Date date)
Formats the given date according to the RFC 1123 pattern.
date
- The date to format.
- An RFC 1123 formatted date string.
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.
date
- The date to format.pattern
- The pattern to use for formatting the date.
parseDate
public static Date parseDate(String dateValue)
throws DateParseException
Parses a date value. The formats used for parsing the date value are retrieved from
the default http params.
dateValue
- the date value to parse
DateParseException
- if the value could not be parsed using any of the
supported date formats
parseDate
public static Date parseDate(String dateValue,
Collection dateFormats)
throws DateParseException
Parses the date value using the given date formats.
dateValue
- the date value to parsedateFormats
- the date formats to use
parseDate
public static Date parseDate(String dateValue,
Collection dateFormats,
Date startDate)
throws DateParseException
Parses the date value using the given date formats.
dateValue
- the date value to parsedateFormats
- the date formats to usestartDate
- 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.
Copyright (c) 1999-2005 - Apache Software Foundation