FileDocCategorySizeDatePackage
CommonFormatter.javaAPI DocphoneME MR2 API (J2ME)7175Wed May 02 18:00:46 BST 2007com.sun.j2me.global

CommonFormatter

public interface CommonFormatter
The CommonFormatter interface defines methods for platform-dependent data formatting that {@link javax.microedition.global.Formatter} realization classes must implement.

Fields Summary
Constructors Summary
Methods Summary
public java.lang.StringformatCurrency(double number)
Formats a currency amount using locale-specific rules. This method assumes that the amount is in the locale's currency. The result uses the locale-specific decimal separator and may include grouping separators. The number of decimals is also locale-specific.

This method does not perform any currency conversions based on exchange rates.

param
number the currency amount to format
return
the formatted currency amount

public java.lang.StringformatCurrency(double number, java.lang.String currencyCode)
Formats a currency amount using the locale-specific rules but using the symbol of the specified currency. The currency is specified using its ISO 4217 three-letter code, such as "USD", "EUR" or "GBP". If there is a currency symbol attached to the ISO 4217 code in the implementation, that symbol MUST be used instead of the locale's currency symbol. If the implementation does not provide a currency symbol for a given ISO 4217 code, the code MUST be used as such.

The result uses the locale-specific decimal separator and may include grouping separators. The number of decimals is also locale-specific.

This method does not perform any currency conversions based on exchange rates.

param
number the currency amount to format
param
currencyCode the ISO 4217 currency code to use
return
formatted currency amount

public java.lang.StringformatDateTime(java.util.Calendar dateTime, int style)
Formats a date/time instance using locale-specific rules. The style parameter determines the extent and style of the result.

If dateTime has an associated java.util.TimeZone object, dateTime MUST be interpreted as "wall time", not universal time. The offset of that time zone MUST be reflected in the formatted time.

param
dateTime the date and time to format
param
style the formatting style to use
return
the date and/or time formatted as a string

public java.lang.StringformatNumber(double number)
Formats a decimal number using locale-specific rules. The result includes a locale-specific decimal separator and may include grouping separators.

The symbols used for negative and positive infinity and NaN are implementation-specific. Implementations MAY use the appropriate Unicode character (U+221F INFINITY) if applicable.

param
number the number to format
return
formatted decimal number

public java.lang.StringformatNumber(double number, int decimals)
Formats a decimal number using locale-specific rules, with the specified number of decimals. The result includes a locale-specific decimal separator and may include grouping separators.

The number of decimals MUST be between 1 and 15. The formatted result MUST have exactly the specified number of decimals, even if some of the trailing digits are zeroes.

The symbols used for negative and positive infinity and NaN are implementation-specific. Implementations MAY use the appropriate Unicode character (U+221F INFINITY) if applicable.

param
number the number to format
param
decimals number of decimals
return
formatted decimal number

public java.lang.StringformatNumber(long number)
Formats an integer using locale-specific rules. The result may include grouping separators.

param
number the number to format
return
formatted integer number

public java.lang.StringformatPercentage(long number)
Formats an integral percentage value using locale-specific rules. This method places the locale-specific percent sign at the correct position in relation to the number, with the appropriate number of space (possibly none) between the sign and the number.

A percentage is expressed as an integer value. Negative percentages are allowed.

param
number the number to format
return
formatted percentage number

public java.lang.StringformatPercentage(float number, int decimals)
Formats a percentage with the specified number of decimals using locale-specific rules. This method places the locale-specific percent sign at the correct position in relation to the number, with the appropriate amount of space (possibly none) between the sign and the number.

A percentage is expressed as a decimal number, with the value 0.0 interpreted as 0% and the value 1.0 as 100%. Percentages larger than 100% are expressed as values greater than 1.0. Negative percentages are allowed, and expressed as values smaller than 0.0. The percentage is rounded to the specified number of decimals.

The number of decimals MUST be between 1 and 15. The formatted result MUST have exactly the specified number of decimals, even if some of the trailing digits are zeroes.

param
number the percentage to format, expressed as a positive or negative number
param
decimals the number of decimals to use (1 <= decimals <= 15)
return
formatted percentage string