Package org.eclipse.jetty.util

Class DateCache

java.lang.Object

org.eclipse.jetty.util.DateCache

public class DateCache
extends Object

Computes String representations of Dates then caches the results so that subsequent requests within the same second will be fast.

If consecutive calls are frequently very different, then this may be a little slower than a normal DateFormat.

See Also:

• for date formatting patterns.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DateCache.Tick

Field Summary

Fields

Modifier and Type	Field	Description
static final String	DEFAULT_FORMAT

Constructor Summary

Constructors

Constructor	Description
DateCache()	Make a DateCache that will use a default format.
DateCache(String format)	Make a DateCache that will use the given format.
DateCache(String format, Locale l)
DateCache(String format, Locale l, String tz)
DateCache(String format, Locale l, TimeZone tz)
DateCache(String format, Locale l, TimeZone tz, boolean subSecondPrecision)

Method Summary

Modifier and Type	Method	Description
protected String	doFormat(long inDate, DateTimeFormatter formatter)	Format a date according to supplied formatter.
String	format(long inDate)	Format a date according to our stored formatter.
String	format(Date inDate)	Format a date according to our stored formatter.
String	formatNow(long now)	Deprecated. use format(long)
protected DateCache.Tick	formatTick(long inDate)
String	getFormatString()
TimeZone	getTimeZone()
String	now()	Deprecated.
DateCache.Tick	tick()	Deprecated.

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_FORMAT

public static final String DEFAULT_FORMAT

See Also:

• Constant Field Values

Constructor Details

DateCache

public DateCache()

Make a DateCache that will use a default format. The default format generates the same results as Date.toString().

DateCache

public DateCache(String format)

Make a DateCache that will use the given format.

Parameters:

format - the format to use

DateCache

public DateCache(String format,
 Locale l)

DateCache

public DateCache(String format,
 Locale l,
 String tz)

DateCache

public DateCache(String format,
 Locale l,
 TimeZone tz)

DateCache

public DateCache(String format,
 Locale l,
 TimeZone tz,
 boolean subSecondPrecision)

Method Details

getTimeZone

public TimeZone getTimeZone()

format

public String format(Date inDate)

Format a date according to our stored formatter. If it happens to be in the same second as the last formatNow call, then the format is reused.

Parameters:

inDate - the Date.

Returns:

Formatted date.

format

public String format(long inDate)

Format a date according to our stored formatter. If it happens to be in the same second as the last formatNow call, then the format is reused.

Parameters:

inDate - the date in milliseconds since unix epoch.

Returns:

Formatted date.

doFormat

protected String doFormat(long inDate,
 DateTimeFormatter formatter)

Format a date according to supplied formatter.

Parameters:

inDate - the date in milliseconds since unix epoch.

Returns:

Formatted date.

formatNow

@Deprecated
public String formatNow(long now)

Deprecated.

use format(long)

Format a date according to our stored formatter. The passed time is expected to be close to the current time, so it is compared to the last value passed and if it is within the same second, the format is reused. Otherwise, a new cached format is created.

Parameters:

now - the milliseconds since unix epoch

Returns:

Formatted date

now

@Deprecated
public String now()

Deprecated.

tick

@Deprecated
public DateCache.Tick tick()

Deprecated.

formatTick

protected DateCache.Tick formatTick(long inDate)

getFormatString

public String getFormatString()