com.twelvemonkeys.util

Class TimeFormat

java.lang.Object

java.text.Format

com.twelvemonkeys.util.TimeFormat

All Implemented Interfaces:

Serializable, Cloneable

public class TimeFormat
extends Format

Format for converting and parsing time.

The format is expressed in a string as follows:

m (or any multiple of m's)

the minutes part (padded with 0's, if number has less digits than the number of m's) m -> 0,1,...,59,60,61,... mm -> 00,01,...,59,60,61,...

s or ss

the seconds part (padded with 0's, if number has less digits than the number of s's) s -> 0,1,...,59 ss -> 00,01,...,59

S

all seconds (including the ones above 59)

May not handle all cases, and formats... ;-) Safest is: Always delimiters between the minutes (m) and seconds (s) part.

TODO: Move to com.twelvemonkeys.text? Milliseconds! Fix bugs. Known bugs:

The last character in the formatString is not escaped, while it should be. The first character after an escaped character is escaped while is shouldn't be.

This is not a 100% compatible implementation of a java.text.Format.

Author:

Harald Kuhr

See Also:

Time, Serialized Form

Nested Class Summary

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

Format.Field

Field Summary

Fields

Modifier and Type	Field and Description
protected String	formatString
protected com.twelvemonkeys.util.TimeFormatter[]	formatter The formatter array.

Constructor Summary

Constructors

Constructor and Description
TimeFormat(String pStr) Creates a new TimeFormat with the given formatString,

Method Summary

Methods

Modifier and Type	Method and Description
StringBuffer	format(Object pObj, StringBuffer pToAppendTo, FieldPosition pPos) DUMMY IMPLEMENTATION!!
String	format(Time pTime) Formats the the given time, using this format.
String	getFormatString() Gets the format string.
static TimeFormat	getInstance() DUMMY IMPLEMENTATION!! Not locale specific.
Time	parse(String pStr) Parses a Time, according to this format.
Object	parseObject(String pStr, ParsePosition pStatus) DUMMY IMPLEMENTATION!!

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

Field Detail

formatString

protected String formatString

formatter

protected com.twelvemonkeys.util.TimeFormatter[] formatter

The formatter array.

Constructor Detail

TimeFormat

public TimeFormat(String pStr)

Creates a new TimeFormat with the given formatString,

Method Detail

getInstance

public static TimeFormat getInstance()

DUMMY IMPLEMENTATION!! Not locale specific.

getFormatString

public String getFormatString()

Gets the format string.

format

public StringBuffer format(Object pObj,
                  StringBuffer pToAppendTo,
                  FieldPosition pPos)

DUMMY IMPLEMENTATION!!

Specified by:

format in class Format

format

public String format(Time pTime)

Formats the the given time, using this format.

parseObject

public Object parseObject(String pStr,
                 ParsePosition pStatus)

DUMMY IMPLEMENTATION!!

Specified by:

parseObject in class Format

parse

public Time parse(String pStr)

Parses a Time, according to this format.

Will bug on some formats. It's safest to always use delimiters between the minutes (m) and seconds (s) part.