Examples of com.ibm.icu.math.BigDecimal

com.ibm.icu.math.BigDecimal
hursley.ibm.com/decimal
[This URL will change.]
Operator methods

Operations on BigDecimal numbers are controlled by a {@link MathContext} object, which provides the context (precision andother information) for the operation. Methods that can take a MathContext parameter implement the standard arithmetic operators for BigDecimal objects and are known as operator methods. The default settings provided by the constant {@link MathContext#DEFAULT} (digits=9,form=SCIENTIFIC, lostDigits=false, roundingMode=ROUND_HALF_UP) perform general-purpose floating point arithmetic to nine digits of precision. The MathContext parameter must not be null.
Each operator method also has a version provided which does not take a MathContext parameter. For this version of each method, the context settings used are digits=0, form=PLAIN, lostDigits=false, roundingMode=ROUND_HALF_UP; these settings perform fixed point arithmetic with unlimited precision, as defined for the original BigDecimal class in Java 1.1 and Java 1.2.
For monadic operators, only the optional MathContext parameter is present; the operation acts upon the current object.
For dyadic operators, a BigDecimal parameter is always present; it must not be null. The operation acts with the current object being the left-hand operand and the BigDecimal parameter being the right-hand operand.
For example, adding two BigDecimal objects referred to by the names award and extra could be written as any of:
award.add(extra) award.add(extra, MathContext.DEFAULT) award.add(extra, acontext)
(where acontext is a MathContext object), which would return a BigDecimal object whose value is the result of adding award and extra under the appropriate context settings.
When a BigDecimal operator method is used, a set of rules define what the result will be (and, by implication, how the result would be represented as a character string). These rules are defined in the BigDecimal arithmetic documentation (see the URL above), but in summary:
- Results are normally calculated with up to some maximum number of significant digits. For example, if the MathContext parameter for an operation were MathContext.DEFAULT then the result would be rounded to 9 digits; the division of 2 by 3 would then result in 0.666666667.
  You can change the default of 9 significant digits by providing the method with a suitable MathContext object. This lets you calculate using as many digits as you need -- thousands, if necessary. Fixed point (scaled) arithmetic is indicated by using a digits setting of 0 (or omitting the MathContext parameter).
  Similarly, you can change the algorithm used for rounding from the default "classic" algorithm.
- In standard arithmetic (that is, when the form setting is not PLAIN), a zero result is always expressed as the single digit '0' (that is, with no sign, decimal point, or exponent part).
- Except for the division and power operators in standard arithmetic, trailing zeros are preserved (this is in contrast to binary floating point operations and most electronic calculators, which lose the information about trailing zeros in the fractional part of results).
  So, for example:
  new BigDecimal("2.40").add( new BigDecimal("2")) => "4.40" new BigDecimal("2.40").subtract(new BigDecimal("2")) => "0.40" new BigDecimal("2.40").multiply(new BigDecimal("2")) => "4.80" new BigDecimal("2.40").divide( new BigDecimal("2"), def) => "1.2"
  where the value on the right of the => would be the result of the operation, expressed as a String, and def (in this and following examples) refers to MathContext.DEFAULT). This preservation of trailing zeros is desirable for most calculations (including financial calculations). If necessary, trailing zeros may be easily removed using division by 1.
- In standard arithmetic, exponential form is used for a result depending on its value and the current setting of digits (the default is 9 digits). If the number of places needed before the decimal point exceeds the digits setting, or the absolute value of the number is less than 0.000001, then the number will be expressed in exponential notation; thus
  new BigDecimal("1e+6").multiply(new BigDecimal("1e+6"), def)
  results in 1E+12 instead of 1000000000000, and
  new BigDecimal("1").divide(new BigDecimal("3E+10"), def)
  results in 3.33333333E-11 instead of 0.0000000000333333333.
  The form of the exponential notation (scientific or engineering) is determined by the form setting.
  The names of methods in this class follow the conventions established by java.lang.Number, java.math.BigInteger, and java.math.BigDecimal in Java 1.1 and Java 1.2. @see MathContext @author Mike Cowlishaw @stable ICU 2.0

   * 
   * @stable ICU 3.2
   */
  public static BigDecimal toBigDecimal(long universalTime, int timeScale) {
    TimeScaleData data = getTimeScaleData(timeScale);
    BigDecimal universal = new BigDecimal(universalTime);
    BigDecimal units = new BigDecimal(data.units);
    BigDecimal epochOffset = new BigDecimal(data.epochOffset);


    return universal.divide(units, BigDecimal.ROUND_HALF_UP).subtract(epochOffset);
  }

View Full Code Here

   * 
   * @stable ICU 3.2
   */
  public static BigDecimal toBigDecimal(BigDecimal universalTime, int timeScale) {
    TimeScaleData data = getTimeScaleData(timeScale);
    BigDecimal units = new BigDecimal(data.units);
    BigDecimal epochOffset = new BigDecimal(data.epochOffset);


    return universalTime.divide(units, BigDecimal.ROUND_HALF_UP).subtract(epochOffset);
  }

View Full Code Here

   * @deprecated This API is ICU internal only.
   */
  @Deprecated
  public static BigDecimal toBigDecimalTrunc(BigDecimal universalTime, int timeScale) {
    TimeScaleData data = getTimeScaleData(timeScale);
    BigDecimal units = new BigDecimal(data.units);
    BigDecimal epochOffset = new BigDecimal(data.epochOffset);


    return universalTime.divide(units, BigDecimal.ROUND_DOWN).subtract(epochOffset);
  }

View Full Code Here

    private StringBuffer format(BigInteger number, StringBuffer result,
            FieldPosition fieldPosition, boolean parseAttr) {
        // If we are to do rounding, we need to move into the BigDecimal
        // domain in order to do divide/multiply correctly.
        if (roundingIncrementICU != null) {
            return format(new BigDecimal(number), result, fieldPosition);
        }


        if (multiplier != 1) {
            number = number.multiply(BigInteger.valueOf(multiplier));
        }

View Full Code Here

                        (Number) new Long(big.longValue()) : (Number) big;
                }
            }
            // Handle non-integral values or the case where parseBigDecimal is set
            else {
                BigDecimal big = digitList.getBigDecimalICU(status[STATUS_POSITIVE]);
                n = big;
                if (mult != 1) {
                    n = big.divide(BigDecimal.valueOf(mult),
                            BigDecimal.ROUND_HALF_EVEN);
                }
            }
        }

View Full Code Here

     * @stable ICU 2.0
     */
//#if defined(FOUNDATION10) || defined(ECLIPSE_FRAGMENT)
    public BigDecimal getRoundingIncrement() {
        if (roundingIncrementICU == null) return null;
        return new BigDecimal(roundingIncrementICU.toString());
    }

View Full Code Here

            roundingDouble = newValue;
            if (roundingDouble < 1.0d) {
                double rawRoundedReciprocal = 1.0d/roundingDouble;
                setRoundingDoubleReciprocal(rawRoundedReciprocal);
            }
            setInternalRoundingIncrement(new BigDecimal(newValue));
        }
    }

View Full Code Here

    private StringBuffer format(BigInteger number, StringBuffer result, FieldPosition fieldPosition,
                                boolean parseAttr) {
        // If we are to do rounding, we need to move into the BigDecimal
        // domain in order to do divide/multiply correctly.
        if (roundingIncrementICU != null) {
            return format(new BigDecimal(number), result, fieldPosition);
        }


        if (multiplier != 1) {
            number = number.multiply(BigInteger.valueOf(multiplier));
        }

View Full Code Here

                    n = (big.bitLength() < 64) ? (Number) new Long(big.longValue()) : (Number) big;
                }
            }
            // Handle non-integral values or the case where parseBigDecimal is set
            else {
                BigDecimal big = digitList.getBigDecimalICU(status[STATUS_POSITIVE]);
                n = big;
                if (mult != 1) {
                    n = big.divide(BigDecimal.valueOf(mult), mathContext);
                }
            }
        }


        // Assemble into CurrencyAmount if necessary

View Full Code Here

     */
    public void setRoundingIncrement(java.math.BigDecimal newValue) {
        if (newValue == null) {
            setRoundingIncrement((BigDecimal) null);
        } else {
            setRoundingIncrement(new BigDecimal(newValue));
        }
    }

View Full Code Here

0 1 2 3 4 5 6

TOP

Related Classes of com.ibm.icu.math.BigDecimal

com.ibm.icu.dev.test.format.IntlTestDecimalFormatAPI

com.ibm.icu.dev.test.format.NumberFormatTest

com.ibm.icu.dev.test.serializable.SerializableTest$BigDecimalHandler

com.ibm.icu.dev.test.timescale.TimeScaleAPITest

com.ibm.icu.dev.test.timescale.TimeScaleMonkeyTest

com.ibm.icu.dev.tool.timescale.CalculateLimits

com.ibm.icu.text.DecimalFormat

com.ibm.icu.util.UniversalTimeScale

org.ofbiz.order.thirdparty.taxware.TaxwareServices

org.orangegears.gl.control.setup.LedgerServices

All source code are property of their respective owners. Java is a trademark of Sun Microsystems, Inc and owned by ORACLE Inc. Contact coftware#gmail.com.

Examples of com.ibm.icu.math.BigDecimal

Operator methods

Related Classes of com.ibm.icu.math.BigDecimal