BigDecimal : Java Glossary

BigDecimal

java.math.BigDecimal provides for immutable arbitrary-precision signed decimal numbers. A BigDecimal consists of an arbitrary precision integer unscaled value (a BigInteger 2’s complement variable length array of bytes) and a non-negative 32-bit integer scale, which represents the number of digits to the right of the decimal point. Scales may not be negative. That allows you to work with decimal fractions of arbitrary precision.

To convert a long to a BigDecimal use:

// convert a long to BigDecimal, with some implied decimal places.
BigDecimal d = BigDecimal.valueOf( theLong, decimalPlaces );

You can’t use ordinary arithmetic or comparison operators on BigDecimal. You must use methods likeBigDecimal.add, .subtract, .multiply,. divide, .pow, .abs, .compareTo …

To convert your BigDecimal to a String for display you can use BigDecimal. toString or BigDecimal. toEngineeringString. It is also possible using Formatter and printf.

Watch out! ==, BigDecimal.equals and BigDecimal.compareTo() == 0 all give different results.

== returns true only if the two BigDecimal references to the same object. It is not sufficient they have the same value.
Unlike compareTo, equals considers two BigDecimal objects equal only if they are equal in value and scale (thus 2.0 is not equal to 2.00 when compared by this method).
Two BigDecimal objects that are equal in value but have a different scale (like 2.0 and 2.00) are considered equal by compareTo.

PSPDec (Prospero Software Products Decimal) is a third party library.

Learning More

Oracle’s Javadoc on BigDecimal class : available:

on the web at Oracle.com
in the current JDK 1.7.0_02 or in the old JDK 1.6.0_30 on your local Windows J: drive.

Arcimath
BigInteger
DecimalD Spec
gotchas
IBM’s BigDecimal: a cleanroom implementation of BigDecimal
PSPDec

	You can get the freshest copy of this page from:	or possibly from your local J: drive (Java virtual drive/mindprod.com website mirror)
	http://mindprod.com/jgloss/bigdecimal.html	J:\mindprod\jgloss\bigdecimal.html
	Please email your feedback for publication, letters to the editor, errors, omissions, typos, formatting errors, ambiguities, unclear wording, broken/redirected link reports, suggestions to improve this page or comments to Roedy Green : If you want your message kept confidential, not considered for posting, please explicitly specify that.
	Canadian Mind Products
	mindprod.com IP:[65.110.21.43]
view Blog	Your face IP:[38.107.179.211]
Feedback	You are visitor number 23,586.