Skip navigation links

Oracle® Database Globalization Development Kit Java API Reference
11g Release 2 (11.2)

E10730-01


oracle.i18n.text
Class OraDecimalFormat

java.lang.Object
  extended by java.text.Format
      extended by oracle.i18n.text.OraNumberFormat
          extended by oracle.i18n.text.OraDecimalFormat

All Implemented Interfaces:
Serializable, Cloneable

public class OraDecimalFormat
extends OraNumberFormat

The OraDecimalFormat class is a concrete class to do locale-sensitive formatting and parsing between number and string. It supports Oracle number formatting behavior.

See Also:
OraNumberFormat, Serialized Form

Nested Class Summary

 

Nested classes/interfaces inherited from class java.text.Format
Format.Field

 

Field Summary

 

Fields inherited from class oracle.i18n.text.OraNumberFormat
ALL_FIELD, FRACTION_FIELD, INTEGER_FIELD, SQLImplicit

 

Constructor Summary
OraDecimalFormat()
          Deprecated. As of Oracle Database 10g Release 2 (10.2), replaced by OraDecimalFormat.OraDecimalFormat(String, OraDecimalFormatSymbols)
OraDecimalFormat(String pattern)
          Deprecated. As of Oracle Database 10g Release 2 (10.2), replaced by OraDecimalFormat.OraDecimalFormat(String, OraDecimalFormatSymbols)
OraDecimalFormat(String pattern, OraDecimalFormatSymbols symbols)
          Constructs an OraDecimalFormat object using the given format pattern and the given decimal format symbols.

 

Method Summary
 void applyPattern(String pattern)
          Modifies this formatter by using the given format pattern.
 Object clone()
          Overrides the clone method.
 boolean equals(Object object)
          Overrides the equals method.
 StringBuffer format(BigDecimal number, StringBuffer toAppendTo, FieldPosition fieldPosition)
          Formats a BigDecimal object into a string.
 StringBuffer format(BigInteger number, StringBuffer toAppendTo, FieldPosition fieldPosition)
          Formats a BigInteger object into a string.
 StringBuffer format(double number, StringBuffer toAppendTo, FieldPosition fieldPosition)
          Formats a double number into a string.
 StringBuffer format(long number, StringBuffer toAppendTo, FieldPosition fieldPosition)
          Formats a long number into a string.
 OraDecimalFormatSymbols getOraDecimalFormatSymbols()
          Returns the Oracle decimal format symbols used in this formatter.
 int hashCode()
          Overrides the hashCode method.
 boolean isDecimalSeparatorAlwaysShown()
          Returns true if decimal separator is always shown in the result string.
 Number parse(String text, ParsePosition parsePosition)
          Parses a string into a Number object, starting from the given parse position.
 void setDecimalSeparatorAlwaysShown(boolean val)
          Sets the switch for decimal separator to the given boolean value.
protected  void setMaximumFractionDigits(int val)
           
protected  void setMaximumIntegerDigits(int val)
           
protected  void setMinimumFractionDigits(int val)
           
protected  void setMinimumIntegerDigits(int val)
           
 void setOraDecimalFormatSymbols(OraDecimalFormatSymbols sym)
          Sets this formatter to use the given Oracle decimal format symbols.
 String toPattern()
          Returns a format pattern string that represents the formatting behavior of this formatter.

 

Methods inherited from class oracle.i18n.text.OraNumberFormat
format, format, format, format, format, getCurrencyInstance, getCurrencyInstance, getCurrencyInstance, getDefaultCurrencyFormatPattern, getDefaultCurrencyFormatPattern, getDefaultNumberFormatPattern, getDefaultNumberFormatPattern, getInstance, getInstance, getInstance, getMaximumFractionDigits, getMinimumFractionDigits, getMinimumIntegerDigits, getNumberInstance, getNumberInstance, getNumberInstance, getSQLImplicitInstance, getSQLImplicitInstance, isGroupingUsed, isParseIntegerOnly, parse, parseObject, setGroupingUsed, setParseIntegerOnly

 

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

OraDecimalFormat

public OraDecimalFormat()
Deprecated. As of Oracle Database 10g Release 2 (10.2), replaced by OraDecimalFormat.OraDecimalFormat(String, OraDecimalFormatSymbols)
Constructs an OraDecimalFormat object using the default number format pattern and the default decimal format symbols for the default locale.

OraDecimalFormat

public OraDecimalFormat(String pattern)
                 throws ParseException
Deprecated. As of Oracle Database 10g Release 2 (10.2), replaced by OraDecimalFormat.OraDecimalFormat(String, OraDecimalFormatSymbols)
Constructs an OraDecimalFormat object using the given format pattern and the default decimal format symbols for the default locale.
Parameters:
pattern - the given format pattern, if null, uses the default number format pattern for the default locale and supports SQL TO_CHAR()/TO_NUMBER() implicit conversion.
Throws:
ParseException - if the given pattern is invalid

OraDecimalFormat

public OraDecimalFormat(String pattern,
                        OraDecimalFormatSymbols symbols)
                 throws ParseException
Constructs an OraDecimalFormat object using the given format pattern and the given decimal format symbols.
Parameters:
pattern - the give format pattern, if null, uses the default number format pattern for the default locale and supports SQL TO_CHAR()/TO_NUMBER() implicit conversion.
symbols - the given decimal format symbols
Throws:
ParseException - if the given pattern is invalid

Method Detail

applyPattern

public void applyPattern(String pattern)
                  throws ParseException
Modifies this formatter by using the given format pattern. The given format pattern should be specified as:
  "<positive pattern>[;<negative pattern>]"
This means that a positive format pattern must be present but a negative format pattern is optional. If there is no negative pattern given, the positive pattern with a leading minus sign is used for formatting or parsing negative numbers.
Parameters:
pattern - given format pattern, if null, uses the default number format pattern for the default locale and supports SQL TO_CHAR()/TO_NUMBER() implicit conversion.
Throws:
ParseException - if the given pattern is invalid

format

public StringBuffer format(BigDecimal number,
                           StringBuffer toAppendTo,
                           FieldPosition fieldPosition)
Formats a BigDecimal object into a string. Sets field position if it is needed.
Specified by:
format in class OraNumberFormat
Parameters:
number - the BigDecimal object to be formatted.
toAppendTo - the string buffer to be appended with the formatted string.
fieldPosition - to be used to get offsets of a given field in the returned string buffer. On input, the alignment field of which the offsets are to be returned. On output, the offsets of the alignment field in the returned string buffer.
Returns:
the string buffer appended with a formatted string

format

public StringBuffer format(BigInteger number,
                           StringBuffer toAppendTo,
                           FieldPosition fieldPosition)
Formats a BigInteger object into a string. Sets field position if it is needed.
Specified by:
format in class OraNumberFormat
Parameters:
number - the BigInteger object to be formatted.
toAppendTo - the string buffer to be appended with the formatted string.
fieldPosition - to be used to get offsets of a given field in the returned string buffer. On input, the alignment field of which the offsets are to be returned. On output, the offsets of the alignment field in the returned string buffer.
Returns:
the string buffer appended with a formatted string

format

public StringBuffer format(double number,
                           StringBuffer toAppendTo,
                           FieldPosition fieldPosition)
Formats a double number into a string. Sets field position if it is needed.
Specified by:
format in class OraNumberFormat
Parameters:
number - the double number to be formatted.
toAppendTo - the string buffer to be appended with the formatted string.
fieldPosition - to be used to get offsets of a given field in the returned string buffer. On input, the alignment field of which the offsets are to be returned. On output, the offsets of the alignment field in the returned string buffer.
Returns:
the string buffer appended with a formatted string

format

public StringBuffer format(long number,
                           StringBuffer toAppendTo,
                           FieldPosition fieldPosition)
Formats a long number into a string. Sets field position if it is needed.
Specified by:
format in class OraNumberFormat
Parameters:
number - the long number to be formatted.
toAppendTo - the string buffer to be appended with the formatted string.
fieldPosition - to be used to get offsets of a given field in the returned string buffer. On input, the alignment field of which the offsets are to be returned. On output, the offsets of the alignment field in the returned string buffer.
Returns:
the string buffer appended with a formatted string

parse

public Number parse(String text,
                    ParsePosition parsePosition)
Parses a string into a Number object, starting from the given parse position.
Specified by:
parse in class OraNumberFormat
Parameters:
text - the string
parsePosition - indicates where to start the parsing on input. On output, returns where the parse ends if parsing succeeds, or the start index if it fails.
Returns:
a Number object

isDecimalSeparatorAlwaysShown

public boolean isDecimalSeparatorAlwaysShown()
Returns true if decimal separator is always shown in the result string.
Returns:
a boolean value

setDecimalSeparatorAlwaysShown

public void setDecimalSeparatorAlwaysShown(boolean val)
Sets the switch for decimal separator to the given boolean value.
Parameters:
val - the given boolean value

getOraDecimalFormatSymbols

public OraDecimalFormatSymbols getOraDecimalFormatSymbols()
Returns the Oracle decimal format symbols used in this formatter.
Returns:
an OraDecimalFormatSymbols object
See Also:
OraDecimalFormatSymbols

setOraDecimalFormatSymbols

public void setOraDecimalFormatSymbols(OraDecimalFormatSymbols sym)
Sets this formatter to use the given Oracle decimal format symbols.
Parameters:
sym - the given Oracle decimal format symbols

toPattern

public String toPattern()
Returns a format pattern string that represents the formatting behavior of this formatter.
Returns:
a format pattern string

setMaximumIntegerDigits

protected void setMaximumIntegerDigits(int val)
Overrides:
setMaximumIntegerDigits in class OraNumberFormat

setMinimumIntegerDigits

protected void setMinimumIntegerDigits(int val)
Overrides:
setMinimumIntegerDigits in class OraNumberFormat

setMaximumFractionDigits

protected void setMaximumFractionDigits(int val)
Overrides:
setMaximumFractionDigits in class OraNumberFormat

setMinimumFractionDigits

protected void setMinimumFractionDigits(int val)
Overrides:
setMinimumFractionDigits in class OraNumberFormat

clone

public Object clone()
Overrides the clone method.
Overrides:
clone in class OraNumberFormat
Returns:
a cloned object

equals

public boolean equals(Object object)
Overrides the equals method.
Overrides:
equals in class OraNumberFormat
Parameters:
object - an object to be compared
Returns:
true if two objects are identical, otherwise false

hashCode

public int hashCode()
Overrides the hashCode method.
Overrides:
hashCode in class Object
Returns:
a hash value for the object

Skip navigation links

Oracle® Database Globalization Development Kit Java API Reference
11g Release 2 (11.2)

E10730-01


Copyright © 2003, 2009, Oracle. All rights reserved.