er.extensions.formatters

Class ERXTimeDurationFormatter

java.lang.Object

java.text.Format

java.text.NumberFormat

er.extensions.formatters.ERXTimeDurationFormatter

All Implemented Interfaces:

Serializable, Cloneable

public class ERXTimeDurationFormatter
extends NumberFormat

User-presentable time duration format as days, hours, minutes and seconds. Usage example: StopWatch w = new StopWatch(); w.start(); ... perform long task ... w.stop(); ERXTimeDurationFormatter f = new ERXTimeDurationFormatter(TimeUnit.MILLISECONDS); String message = "The task took " + f.format(w.getTime());

See Also:

Serialized Form

Author:

kieran

Nested Class Summary

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

NumberFormat.Field

Field Summary

Fields inherited from class java.text.NumberFormat

FRACTION_FIELD, INTEGER_FIELD

Constructor Summary

Constructors

Constructor and Description
ERXTimeDurationFormatter() Defaults to TimeUnit.SECONDS, showing all time units and showing seconds part of the time description.
ERXTimeDurationFormatter(TimeUnit timeUnit) Defaults to showing all time units and showing seconds part of the time description.
ERXTimeDurationFormatter(TimeUnit timeUnit, boolean showLargestUnitOnly, boolean omitSecondsPart)

Method Summary

Modifier and Type	Method and Description
StringBuffer	format(double number, StringBuffer toAppendTo, FieldPosition pos)
StringBuffer	format(long number, StringBuffer toAppendTo, FieldPosition fieldPosition)
Number	parse(String source, ParsePosition parsePosition) I know it is lame, but parsing is unsupported.

Methods inherited from class java.text.NumberFormat

clone, equals, format, format, format, getAvailableLocales, getCurrency, getCurrencyInstance, getCurrencyInstance, getInstance, getInstance, getIntegerInstance, getIntegerInstance, getMaximumFractionDigits, getMaximumIntegerDigits, getMinimumFractionDigits, getMinimumIntegerDigits, getNumberInstance, getNumberInstance, getPercentInstance, getPercentInstance, getRoundingMode, hashCode, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setCurrency, setGroupingUsed, setMaximumFractionDigits, setMaximumIntegerDigits, setMinimumFractionDigits, setMinimumIntegerDigits, setParseIntegerOnly, setRoundingMode

Methods inherited from class java.text.Format

format, formatToCharacterIterator, parseObject

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ERXTimeDurationFormatter

public ERXTimeDurationFormatter()

Defaults to TimeUnit.SECONDS, showing all time units and showing seconds part of the time description.

ERXTimeDurationFormatter

public ERXTimeDurationFormatter(TimeUnit timeUnit)

Defaults to showing all time units and showing seconds part of the time description.

Parameters:

timeUnit - the unit of time which is milliseconds, seconds, etc.

ERXTimeDurationFormatter

public ERXTimeDurationFormatter(TimeUnit timeUnit,
                                boolean showLargestUnitOnly,
                                boolean omitSecondsPart)

Parameters:

timeUnit - the unit of time which is milliseconds, seconds, etc.

showLargestUnitOnly - display the largest time unit (days, hours, minutes or seconds) that the time value rounds down to

omitSecondsPart - imit the seconds unit from the format.

Method Detail

format

public StringBuffer format(double number,
                           StringBuffer toAppendTo,
                           FieldPosition pos)

Specified by:

format in class NumberFormat

format

public StringBuffer format(long number,
                           StringBuffer toAppendTo,
                           FieldPosition fieldPosition)

Specified by:

format in class NumberFormat

parse

public Number parse(String source,
                    ParsePosition parsePosition)

I know it is lame, but parsing is unsupported.

Specified by:

parse in class NumberFormat

See Also:

NumberFormat.parse(java.lang.String, java.text.ParsePosition)