"...it is a bad idea to use floating point to try to represent exact quantities like monetary amounts. Using floating point for dollars-and-cents calculations is a recipe for disaster. Floating point numbers are best reserved for values such as measurements, whose values are fundamentally inexact to begin with." -- Brian Goetz
Java lacks built-in type to represent Money or Quantity properties frequently used in financial domain.
Ideal data type for this purpose:
- Use base-10 (rather than base-2) to accurately represent monetary values
- Support wide range of values (ranging from hundred of billions of that represent portfolio values to fractions of 6 to 8 below decimal point to represent smallest tick sizes)
- Allow GC-free arithmetic (Garbage Collection pauses are evil in low-latency systems). This most likely implies using primitive data types.
- fast (as fast as non-builtin numeric data type could be)
- Support efficient conversion to String and double
DFP uses Java long to represent base-10 floating point numbers. DFP is based on IEEE 754-2008 standard.
Add dependency (Gradle):
implementation 'com.epam.deltix:dfp:1.0.3'
Use:
import com.epam.deltix.dfp.Decimal64Utils;
@Decimal long price = Decimal64Utils.parse ("123.45");
@Decimal long halfPrice = Decimal64Utils.divideByInteger (price, 2);
DFP was inspired on Intel Decimal Floating-Point Math Library that is written in C and provides implementation for IEEE 754-2008. Early DFP versions used JNI wrappers for this Intel library. Starting from the release 0.12 DFP is 100% Java.
DFP for Java runs on all platforms where Java is supported.
DFP for .NET supports the following platforms:
- x86-64 (Windows, Linux, Mac)
- x86 (Windows, Linux)
- arm64 (Linux, Mac)
- arm7 (Linux)
This project was developed by Deltix developers Vitali Haravy, Boris Chuprin, Andrei Davydov.
This software uses Intel Decimal Floating Point Math Library.
This library is released under Apache 2.0 license. See (license)