js.format

Class Duration

java.lang.Object

js.format.Duration

All Implemented Interfaces:

Format

public final class Duration
extends Object
implements Format

Format duration value, in milliseconds - 12.30 min. Duration format has a numeric part and units; units are selected so that duration to be represented with smallest numeric part but greater or equals one. Numeric part is formatted according locale settings and always has two decimals. For supported units take a look at Duration.Units class.

Version:

final

Author:

Iulian Rotaru

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	Duration.Units Duration measurement units.

Field Summary

Fields

Modifier and Type	Field and Description
private NumberFormat	numberFormat Formatter for duration numeric part.

Constructor Summary

Constructors

Constructor and Description
Duration() Construct duration formatter instance with default locale.
Duration(Locale locale) Construct duration formatter instance for requested locale settings.

Method Summary

Modifier and Type	Method and Description
private String	format(double duration, Duration.Units units) Build time duration representation for given numeric value and units.
String	format(Object value) Format a integer or long value as a time duration.
Object	parse(String value) Parse time duration from given string value and return it as Long instance.

Methods inherited from class java.lang.Object

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

Field Detail

numberFormat

private NumberFormat numberFormat

Formatter for duration numeric part. It is subject of locale adjustments.

Constructor Detail

Duration

public Duration()

Construct duration formatter instance with default locale.

Duration

public Duration(Locale locale)

Construct duration formatter instance for requested locale settings.

Parameters:

locale - locale settings.

Method Detail

format

public String format(Object value)

Format a integer or long value as a time duration. Returns empty string if value argument is null.

Specified by:

format in interface Format

Parameters:

value - numeric value.

Returns:

numeric value represented as duration, possible empty if value argument is null.

Throws:

IllegalArgumentException - if value argument is not integer or long.

parse

public Object parse(String value)
             throws ParseException

Parse time duration from given string value and return it as Long instance. Given string value should have a numeric part followed by units, separated by space. See Duration.Units for supported units.

Returns null if value argument is null or empty.

Specified by:

parse in interface Format

Parameters:

value - formatted time duration value.

Returns:

file size as Long instance, possible null if value argument is null or empty.

Throws:

ParseException - if value is not formated as described above.

format

private String format(double duration,
                      Duration.Units units)

Build time duration representation for given numeric value and units.

Parameters:

duration - duration numeric part value,

units - bit rate units.

Returns:

formated bit rate.