Modifier and Type	Class and Description
pack-priv static class	DateUtils.DateFormatHolder A factory for `SimpleDateFormat`s.

Field Summary

Modifier and Type	Field and Description
private static final String[]	DEFAULT_PATTERNS
private static final Date	DEFAULT_TWO_DIGIT_YEAR_START
public static final TimeZone	GMT
public static final String	PATTERN_ASCTIME Date format pattern used to parse HTTP date headers in ANSI C `asctime()` format.
public static final String	PATTERN_RFC1036 Date format pattern used to parse HTTP date headers in RFC 1036 format.
public static final String	PATTERN_RFC1123 Date format pattern used to parse HTTP date headers in RFC 1123 format.

Access	Constructor and Description
private	DateUtils() This class should not be instantiated.

Method Summary

Modifier and Type	Method and Description
public static void	clearThreadLocal() Clears thread-local variable containing `java.text.DateFormat` cache.
public static String	Returns: An RFC 1123 formatted date string. formatDate(final Date The date to format. date) Formats the given date according to the RFC 1123 pattern.
public static String	Returns: A formatted date string. formatDate(final Date The date to format. date, final String The pattern to use for formatting the date. pattern) Formats the given date according to the specified pattern.
public static Date	Returns: the parsed date or null if input could not be parsed parseDate(final String the date value to parse dateValue) Parses a date value.
public static Date	Returns: the parsed date or null if input could not be parsed parseDate(final String the date value to parse dateValue, final String[] the date formats to use dateFormats) Parses the date value using the given date formats.
public static Date	Returns: the parsed date or null if input could not be parsed parseDate(final String the date value to parse dateValue, final String[] the date formats to use dateFormats, final Date 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. startDate) Parses the date value using the given date formats.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

DEFAULT_PATTERNS	back to summary
private static final String[] DEFAULT_PATTERNS

DEFAULT_TWO_DIGIT_YEAR_START	back to summary
private static final Date DEFAULT_TWO_DIGIT_YEAR_START

GMT	back to summary
public static final TimeZone GMT

PATTERN_ASCTIME	back to summary
public static final String PATTERN_ASCTIME Date format pattern used to parse HTTP date headers in ANSI C `asctime()` format.

PATTERN_RFC1036	back to summary
public static final String PATTERN_RFC1036 Date format pattern used to parse HTTP date headers in RFC 1036 format.

PATTERN_RFC1123	back to summary
public static final String PATTERN_RFC1123 Date format pattern used to parse HTTP date headers in RFC 1123 format.

Constructor Detail

DateUtils	back to summary
private DateUtils() This class should not be instantiated.

Method Detail

clearThreadLocal back to summary

clearThreadLocal	back to summary
public static void clearThreadLocal() Clears thread-local variable containing `java.text.DateFormat` cache. Since 4.3

public static void clearThreadLocal()

Clears thread-local variable containing java.text.DateFormat cache.

Since: 4.3

formatDate back to summary

formatDate	back to summary
public static String formatDate(final Date date) Formats the given date according to the RFC 1123 pattern. Parameters date:Date The date to format. Returns:String An RFC 1123 formatted date string. See Also `PATTERN_RFC1123`

public static String formatDate(final Date date)

Formats the given date according to the RFC 1123 pattern.

Parameters

date:Date: The date to format.

Returns:String

An RFC 1123 formatted date string.

See Also

PATTERN_RFC1123

formatDate back to summary

formatDate	back to summary
public static String formatDate(final Date date, final 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:Date The date to format. pattern:String The pattern to use for formatting the date. Returns:String A formatted date string. Exceptions IllegalArgumentException: If the given date pattern is invalid. See Also `SimpleDateFormat`

public static String formatDate(final Date date, final 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:Date: The date to format.
pattern:String: The pattern to use for formatting the date.

Returns:String

A formatted date string.

Exceptions

IllegalArgumentException:: If the given date pattern is invalid.

See Also

SimpleDateFormat

parseDate	back to summary
public static Date parseDate(final String dateValue) Parses a date value. The formats used for parsing the date value are retrieved from the default http params. Parameters dateValue:String the date value to parse Returns:Date the parsed date or null if input could not be parsed

parseDate

back to summary

public static Date parseDate(final String dateValue)

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

Parameters

dateValue:String: the date value to parse

Returns:Date

the parsed date or null if input could not be parsed

parseDate	back to summary
public static Date parseDate(final String dateValue, final String[] dateFormats) Parses the date value using the given date formats. Parameters dateValue:String the date value to parse dateFormats:String[] the date formats to use Returns:Date the parsed date or null if input could not be parsed

parseDate

back to summary

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

Parses the date value using the given date formats.

Parameters

dateValue:String: the date value to parse
dateFormats:String[]: the date formats to use

Returns:Date

the parsed date or null if input could not be parsed

parseDate back to summary

parseDate	back to summary
public static Date parseDate(final String dateValue, final String[] dateFormats, final Date startDate) Parses the date value using the given date formats. Parameters dateValue:String the date value to parse dateFormats:String[] the date formats to use startDate:Date 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:Date the parsed date or null if input could not be parsed

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

Parses the date value using the given date formats.

Parameters

dateValue:String: the date value to parse
dateFormats:String[]: the date formats to use
startDate:Date: 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:Date

the parsed date or null if input could not be parsed

org.apache.http.client.utils back to summary

pack-priv final Class DateUtils.DateFormatHolder

Class Inheritance

extends Object

java.lang.Object
org.apache.http.client.utils.DateUtils.DateFormatHolder

A factory for SimpleDateFormats. The instances are stored in a threadlocal way because SimpleDateFormat is not threadsafe as noted in its javadoc.

Field Summary

Modifier and Type	Field and Description
private static final ThreadLocal<SoftReference<Map<String, SimpleDateFormat>>>	THREADLOCAL_FORMATS

Constructor Summary

Access	Constructor and Description
pack-priv	DateFormatHolder()

Method Summary

Modifier and Type	Method and Description
public static void	clearThreadLocal()
public static SimpleDateFormat	Returns: the requested format. This simple dateformat should not be used to `apply` to a different pattern. formatFor(final String a non-`null` format String according to `SimpleDateFormat`. The format is not checked against `null` since all paths go through `DateUtils`. pattern) creates a `SimpleDateFormat` for the requested format string.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

THREADLOCAL_FORMATS	back to summary
private static final ThreadLocal<SoftReference<Map<String, SimpleDateFormat>>> THREADLOCAL_FORMATS

Constructor Detail

DateFormatHolder	back to summary
pack-priv DateFormatHolder()

Method Detail

clearThreadLocal	back to summary
public static void clearThreadLocal()

formatFor back to summary

formatFor	back to summary
public static SimpleDateFormat formatFor(final String pattern) creates a `SimpleDateFormat` for the requested format string. Parameters pattern:String a non-`null` format String according to `SimpleDateFormat`. The format is not checked against `null` since all paths go through `DateUtils`. Returns:SimpleDateFormat the requested format. This simple dateformat should not be used to `apply` to a different pattern.

public static SimpleDateFormat formatFor(final String pattern)

creates a SimpleDateFormat for the requested format string.

Parameters

pattern:String: a non-null format String according to SimpleDateFormat. The format is not checked against null since all paths go through DateUtils.

Returns:SimpleDateFormat

the requested format. This simple dateformat should not be used to apply to a different pattern.

public final Class DateUtils

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class DateUtils.DateFormatHolder

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail