org.rhq.core.clientapi.util.units
Class DateFormatter

java.lang.Object
  org.rhq.core.clientapi.util.units.DateFormatter

All Implemented Interfaces:

Formatter

public class DateFormatter
extends Object
implements Formatter

Nested Class Summary

static class

DateFormatter.DateSpecifics

Constructor Summary

DateFormatter()

Method Summary

FormattedNumber	format(UnitNumber val, Locale locale)
FormattedNumber	format(UnitNumber val, Locale locale, FormatSpecifics specifics) Format a number with the given locale.
FormattedNumber[]	formatSame(double[] val, UnitsConstants unitType, ScaleConstants scale, Locale locale)
FormattedNumber[]	formatSame(double[] val, UnitsConstants unitType, ScaleConstants scale, Locale locale, FormatSpecifics specifics) Format a several values at once into the same format.
static BigDecimal	getBaseTime(double value, ScaleConstants scale)
BigDecimal	getBaseValue(double value, ScaleConstants scale) Get the base value of a value, given its scale.
static BigDecimal	getScaledTime(BigDecimal value, ScaleConstants targScale)
BigDecimal	getScaledValue(BigDecimal value, ScaleConstants targScale) Get a scaled version of a value.
UnitNumber	parse(String val, Locale locale, ParseSpecifics specifics) Parse a string into a UnitNumber.

Methods inherited from class java.lang.Object

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

Constructor Detail

DateFormatter

public DateFormatter()

Method Detail

format

public FormattedNumber format(UnitNumber val,
                              Locale locale)

format

public FormattedNumber format(UnitNumber val,
                              Locale locale,
                              FormatSpecifics specifics)

Description copied from interface: Formatter

Format a number with the given locale.

Specified by:

format in interface Formatter

Parameters:

val - Value to format

locale - Locale that the resultant format should be in

specifics - Optional format to give specific hints to the formatter about how the result should look.

formatSame

public FormattedNumber[] formatSame(double[] val,
                                    UnitsConstants unitType,
                                    ScaleConstants scale,
                                    Locale locale)

formatSame

public FormattedNumber[] formatSame(double[] val,
                                    UnitsConstants unitType,
                                    ScaleConstants scale,
                                    Locale locale,
                                    FormatSpecifics specifics)

Description copied from interface: Formatter

Format a several values at once into the same format. I.e. no matter the discrepency of range, they all contain the same units (megabytes, etc.)

Specified by:

formatSame in interface Formatter

Parameters:

val - Values to format

unitType - One of UnitsConstants.UNIT_*

scale - One of UnitsConstants.SCALE_*

locale - Locale that the resultant format should be in

specifics - Optional format to give specific hints to the formatter about how the result should look.

getBaseValue

public BigDecimal getBaseValue(double value,
                               ScaleConstants scale)

Description copied from interface: Formatter

Get the base value of a value, given its scale. E.x.: getBaseValue(1, SCALE_KILO) -> 1024 (bytes being the base unit)

Specified by:

getBaseValue in interface Formatter

Parameters:

value - Value to get the base of

scale - Scale of the value -- must be valid for the formatter unit type

getScaledValue

public BigDecimal getScaledValue(BigDecimal value,
                                 ScaleConstants targScale)

Description copied from interface: Formatter

Get a scaled version of a value. The value in its base format, and the target scale are passed. The return value will be a number, scaled to the target. E.x.: getScaledValue(1024, SCALE_NONE) -> 1024 getScaledValue(1024, SCALE_KILO) -> 1 (1 kilobyte)

Specified by:

getScaledValue in interface Formatter

Parameters:

value - Value to scale

targScale - Target scale -- must be valid for the formatter unit type

getScaledTime

public static BigDecimal getScaledTime(BigDecimal value,
                                       ScaleConstants targScale)

getBaseTime

public static BigDecimal getBaseTime(double value,
                                     ScaleConstants scale)

parse

public UnitNumber parse(String val,
                        Locale locale,
                        ParseSpecifics specifics)
                 throws ParseException

Description copied from interface: Formatter

Parse a string into a UnitNumber. E.x. parse("34 MB") -> UnitNumber(34, UNIT_BYTES, SCALE_MEGA)

Specified by:

parse in interface Formatter

Parameters:

val - Value to parse

locale - Locale to parse with

specifics - An optional argument which gives the parser more information about parsing

Returns:

the number representing the parsed value

Throws:

ParseException - if the value could not be parsed