org.diirt.util.time

Class TimestampFormat

java.lang.Object

java.text.Format

org.diirt.util.time.TimestampFormat

All Implemented Interfaces:

Serializable, Cloneable

public class TimestampFormat
extends Format

Implements a formatting class to format Timestamps. The format String is exactly the one supported by the SimpleDateFormat, except that it supports the nanosecond field identified by N.

For example, the pattern "yyyy-MM-dd'T'HH:mm:ss.NNNNNNNNNZ" formats to 2001-07-04T12:08:56.012345678-0700

Parsing is not currently supported if nanosecond field is used.

Author:

carcassi

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class java.text.Format

Format.Field

Constructor Summary

Constructors

Constructor and Description
TimestampFormat() Creates a new TimestampFormat using the current Locale.
TimestampFormat(String pattern) Creates a new TimestampFormat using the given pattern and the symbols from the current Locale.
TimestampFormat(String pattern, DateFormatSymbols symbols) Creates a new TimestampFormat using the given pattern and symbols.
TimestampFormat(String pattern, Locale locale) Creates a new TimestampFormat using the given pattern and the symbols from the current Locale.

Method Summary

Modifier and Type	Method and Description
StringBuffer	format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
String	format(Timestamp Timestamp) Formats the given Timestamp.
TimeZone	getTimeZone() Returns the time zone used to format the Timestamp.
Timestamp	parse(String source) Parses a String and converts it to a Timestamp.
Timestamp	parse(String source, ParsePosition pos) Parses the source at the given position.
Object	parseObject(String source, ParsePosition pos)
void	setTimeZome(TimeZone zone) Changes the time zone used to format the Timestamp.

Methods inherited from class java.text.Format

clone, format, formatToCharacterIterator, parseObject

Methods inherited from class java.lang.Object

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

Constructor Detail

TimestampFormat

public TimestampFormat()

Creates a new TimestampFormat using the current Locale.

TimestampFormat

public TimestampFormat(String pattern)

Creates a new TimestampFormat using the given pattern and the symbols from the current Locale.

Parameters:

pattern - the pattern describing the date and time format

TimestampFormat

public TimestampFormat(String pattern,
                       DateFormatSymbols symbols)

Creates a new TimestampFormat using the given pattern and symbols.

Parameters:

pattern - the pattern describing the date and time format

symbols - symbols to be used in formatting

TimestampFormat

public TimestampFormat(String pattern,
                       Locale locale)

Creates a new TimestampFormat using the given pattern and the symbols from the current Locale.

Parameters:

pattern - the pattern describing the date and time format

locale - the Locale to be used

Method Detail

setTimeZome

public void setTimeZome(TimeZone zone)

Changes the time zone used to format the Timestamp.

Parameters:

zone - a new time zone

getTimeZone

public TimeZone getTimeZone()

Returns the time zone used to format the Timestamp.

Returns:

the current time zone

format

public StringBuffer format(Object obj,
                           StringBuffer toAppendTo,
                           FieldPosition pos)

Specified by:

format in class Format

format

public String format(Timestamp Timestamp)

Formats the given Timestamp.

Parameters:

Timestamp - a Timestamp

Returns:

the formatted String

parse

public Timestamp parse(String source,
                       ParsePosition pos)

Parses the source at the given position.

Parameters:

source - text to parse

pos - the position

Returns:

the parsed timestamp

parseObject

public Object parseObject(String source,
                          ParsePosition pos)

Specified by:

parseObject in class Format

parse

public Timestamp parse(String source)
                throws ParseException

Parses a String and converts it to a Timestamp.

Parameters:

source - the string to parse

Returns:

the parsed object

Throws:

ParseException - if the string does not match the pattern