Package org.apache.catalina.util

Class Strftime

java.lang.Object

org.apache.catalina.util.Strftime

public class Strftime
extends Object

Converts dates to strings using the same format specifiers as strftime Note: This does not mimic strftime perfectly. Certain strftime commands, are not supported, and will convert as if they were literals. Certain complicated commands, like those dealing with the week of the year probably don't have exactly the same behavior as strftime. These limitations are due to use SimpleDateTime. If the conversion was done manually, all these limitations could be eliminated. The interface looks like a subset of DateFormat. Maybe someday someone will make this class extend DateFormat.

Version:

$Revision: 1.3 $, $Date: 2005/12/08 01:28:20 $

Author:

Bip Thelin, Dan Sandberg

Field Summary

Fields

Modifier and Type	Field	Description
protected SimpleDateFormat	simpleDateFormat
protected static Properties	translate

Constructor Summary

Constructors

Constructor	Description
Strftime(String origFormat)	Create an instance of this date formatting class
Strftime(String origFormat, Locale locale)	Create an instance of this date formatting class

Method Summary

Modifier and Type	Method	Description
protected String	convertDateFormat(String pattern)	Search the provided pattern and get the C standard Date/Time formatting rules and convert them to the Java equivalent.
String	format(Date date)	Format the date according to the strftime-style string given in the constructor.
TimeZone	getTimeZone()	Get the timezone used for formatting conversions
protected String	quote(String str, boolean insideQuotes)
void	setTimeZone(TimeZone timeZone)	Change the timezone used to format dates
protected boolean	translateCommand(StringBuilder buf, String pattern, int index, boolean oldInside)	try to get the Java Date/Time formating associated with the C standard provided

Methods inherited from class java.lang.Object

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

Field Detail

translate

protected static final Properties translate

simpleDateFormat

protected SimpleDateFormat simpleDateFormat

Constructor Detail

Strftime

public Strftime(String origFormat)

Create an instance of this date formatting class

See Also:

Strftime( String, Locale )

Strftime

public Strftime(String origFormat,
                Locale locale)

Create an instance of this date formatting class

Parameters:

origFormat - the strftime-style formatting string

locale - to use for locale-specific conversions

Method Detail

format

public String format(Date date)

Format the date according to the strftime-style string given in the constructor.

Parameters:

date - the date to format

Returns:

the formatted date

getTimeZone

public TimeZone getTimeZone()

Get the timezone used for formatting conversions

Returns:

the timezone

setTimeZone

public void setTimeZone(TimeZone timeZone)

Change the timezone used to format dates

See Also:

DateFormat.setTimeZone(java.util.TimeZone)

convertDateFormat

protected String convertDateFormat(String pattern)

Search the provided pattern and get the C standard Date/Time formatting rules and convert them to the Java equivalent.

Parameters:

pattern - The pattern to search

Returns:

The modified pattern

quote

protected String quote(String str,
                       boolean insideQuotes)

translateCommand

protected boolean translateCommand(StringBuilder buf,
                                   String pattern,
                                   int index,
                                   boolean oldInside)

try to get the Java Date/Time formating associated with the C standard provided

Parameters:

buf - translated StringBuilder

pattern - command to translate

index - first character index

oldInside - whether to close the quotes if inside quote

Returns:

The Java formatting rule to use