js.format

Class Percent

java.lang.Object

js.format.Percent

All Implemented Interfaces:

Format

public final class Percent
extends Object
implements Format

Percent value format - 12.34%. Percent string representation has a numeric value and a percent symbol, both depending on locale settings.

Percent formatter implementation is based on Java NumberFormat that is not synchronized. Therefore this implementation is not thread safe.

Version:

final

Author:

Iulian Rotaru

Field Summary

Fields

Modifier and Type	Field and Description
private NumberFormat	numberFormat Formatter for percent.

Constructor Summary

Constructors

Constructor and Description
Percent() Create percent formatter with default locale settings.
Percent(Locale locale) Create percent formatter for given locale settings.

Method Summary

Modifier and Type	Method and Description
String	format(Object value) Format numeric value as percent representation using locale settings.
Object	parse(String value) Parse percent from given string value and return it as Number 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 percent. Both numeric part and percent symbol are subject of locale adjustments.

Constructor Detail

Percent

public Percent()

Create percent formatter with default locale settings.

Percent

public Percent(Locale locale)

Create percent formatter for given locale settings.

Parameters:

locale - locale settings.

Method Detail

format

public String format(Object value)

Format numeric value as percent representation using locale settings. Returns empty string if value argument is null.

Specified by:

format in interface Format

Parameters:

value - numeric value.

Returns:

numeric value represented as locale percent or empty string.

Throws:

IllegalArgumentException - if value argument is not an instance of Number.

parse

public Object parse(String value)
             throws ParseException

Parse percent from given string value and return it as Number instance. Given string value should have a numeric part and percent sign and should respect this formatter locale. Returns null if value argument is null or empty.

Specified by:

parse in interface Format

Parameters:

value - percent value.

Returns:

percent as Number instance, possible null if value argument is null or empty.

Throws:

ParseException - if value is not formated as percent.