BigDecimals (The ZKoss Common Library 9.5.0.3 API)

java.lang.Object
- org.zkoss.math.BigDecimals

```
public class BigDecimals
extends Object
```
Utilities and constants of big decimals.

Author:

tomyeh

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`FINE_NUMBER_PRECISION` Represents our fine number precision.
`static int`	`FINE_NUMBER_SCALE` Represents our fine number scale.
`static BigDecimal`	`MINUS_ONE` Represents -1 in big decimal.
`static int`	`NUMBER_PRECISION` Represents our number precision.
`static int`	`NUMBER_SCALE` Represents our number scale.
`static BigDecimal`	`ONE` Represents 1 in big decimal.
`static BigDecimal`	`ZERO` Represents 0 in big decimal.

Constructor Summary

Constructors
Constructor and Description

BigDecimals()

Constructors
Constructor and Description
`BigDecimals()`

Method Summary

All Methods Static Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`static BigDecimal`	`toBigDecimal(byte v)` Converts a byte to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(Byte v)` Converts a byte to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(double v, int scale)` Converts a double to a big decimal with a scale.
`static BigDecimal`	`toBigDecimal(double v, int scale, int roundingMode)` Converts a double to a big decimal with a scale.
`static BigDecimal`	`toBigDecimal(int v)` Converts an integer to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(Integer v)` Converts an integer to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(int v, int scale)` Converts an integer to a big decimal with a scale.
`static BigDecimal`	`toBigDecimal(long v)` Converts a long to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(Long v)` Converts a long to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(long v, int scale)` Converts an integer to a big decimal with a scale.
`static BigDecimal`	`toBigDecimal(short v)` Converts a short to a big decimal with a scale without.
`static BigDecimal`	`toBigDecimal(Short v)` Converts a short to a big decimal with a scale without.
`static String`	`toLocaleString(BigDecimal bd, Locale locale)` Return a string representation of this BigDecimal without an exponent field, which respects the given locale.
`static String`	`toPlainString(BigDecimal bd)` Deprecated. As of release 6.0.0, use BigDecimal.toPlainString() directly (since we don't support JDK 1.4) anymore.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ZERO
```
public static final BigDecimal ZERO
```
    Represents 0 in big decimal.
    
    See Also:
    
    ONE, MINUS_ONE
  - ONE
```
public static final BigDecimal ONE
```
    Represents 1 in big decimal.
    
    See Also:
    
    ZERO, MINUS_ONE
  - MINUS_ONE
```
public static final BigDecimal MINUS_ONE
```
    Represents -1 in big decimal.
    
    See Also:
    
    ZERO, ONE
  - NUMBER_PRECISION
```
public static final int NUMBER_PRECISION
```
    Represents our number precision.
    
    See Also:
    
    Constant Field Values
  - NUMBER_SCALE
```
public static final int NUMBER_SCALE
```
    Represents our number scale.
    
    See Also:
    
    Constant Field Values
  - FINE_NUMBER_PRECISION
```
public static final int FINE_NUMBER_PRECISION
```
    Represents our fine number precision.
    
    See Also:
    
    Constant Field Values
  - FINE_NUMBER_SCALE
```
public static final int FINE_NUMBER_SCALE
```
    Represents our fine number scale.
    
    See Also:
    
    Constant Field Values
- Constructor Detail
  - BigDecimals
```
public BigDecimals()
```
- Method Detail
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(double v,
                                            int scale,
                                            int roundingMode)
```
    Converts a double to a big decimal with a scale.
    It is strongly deprecated to use new Decimal(double) since the scale is unpredictable and usually surprising. For example, BigDecimal(.1) will becomes .1000000000000000055511151231257827021181583404541015625. On the other hand, BigDecimal("0.1") will be 0.1 correctly.
    
    Parameters:
    
    scale - the BigDecimal's scale
    
    roundingMode - the rounding mode
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(double v,
                                            int scale)
```
    Converts a double to a big decimal with a scale. It uses BigDecimal.ROUND_HALF_UP.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(int v,
                                            int scale)
```
    Converts an integer to a big decimal with a scale.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(long v,
                                            int scale)
```
    Converts an integer to a big decimal with a scale.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(int v)
```
    Converts an integer to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(long v)
```
    Converts a long to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(short v)
```
    Converts a short to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(byte v)
```
    Converts a byte to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(Integer v)
```
    Converts an integer to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(Long v)
```
    Converts a long to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(Short v)
```
    Converts a short to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toBigDecimal
```
public static final BigDecimal toBigDecimal(Byte v)
```
    Converts a byte to a big decimal with a scale without. losing precision -- zero scale in this case.
  - toPlainString
```
public static final String toPlainString(BigDecimal bd)
```
    Deprecated. As of release 6.0.0, use BigDecimal.toPlainString() directly (since we don't support JDK 1.4) anymore.
  - toLocaleString
```
public static final String toLocaleString(BigDecimal bd,
                                          Locale locale)
```
    Return a string representation of this BigDecimal without an exponent field, which respects the given locale.
    
    Parameters:
    
    locale - if null, the current user locale is used.
    
    Since:
    
    5.0.10

Class BigDecimals

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ZERO

ONE

MINUS_ONE

NUMBER_PRECISION

NUMBER_SCALE

FINE_NUMBER_PRECISION

FINE_NUMBER_SCALE

Constructor Detail

BigDecimals

Method Detail

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toBigDecimal

toPlainString

toLocaleString