#decimal #financial #fixed #precision

rust_decimal

A Decimal Implementation written in pure Rust suitable for financial calculations

35 releases

✓ Uses Rust 2018 edition

0.11.3 Mar 31, 2019
0.11.1 Feb 11, 2019
0.10.2 Nov 3, 2018
0.9.1 Jun 18, 2018
0.1.0 Nov 16, 2016

#4 in Science

Download history 726/week @ 2018-12-20 167/week @ 2018-12-27 846/week @ 2019-01-03 802/week @ 2019-01-10 1247/week @ 2019-01-17 1265/week @ 2019-01-24 2471/week @ 2019-01-31 1719/week @ 2019-02-07 1465/week @ 2019-02-14 1933/week @ 2019-02-21 2747/week @ 2019-02-28 2655/week @ 2019-03-07 2145/week @ 2019-03-14 2296/week @ 2019-03-21 1906/week @ 2019-03-28

7,797 downloads per month
Used in 19 crates (13 directly)

MIT license

115KB
2.5K SLoC

Decimal   Build Status Latest Version

A Decimal implementation written in pure Rust suitable for financial calculations that require significant integral and fractional digits with no round-off errors.

The binary representation consists of a 96 bit integer number, a scaling factor used to specify the decimal fraction and a 1 bit sign. Because of this representation, trailing zeros are preserved and may be exposed when in string form. These can be truncated using the normalize or round_dp functions.

Documentation

Usage

Decimal numbers can be created in a few distinct ways. The easiest and most optimal method of creating a Decimal is to use the procedural macro within the rust_decimal_macros crate:

// Procedural macros need importing directly
use rust_decimal_macros::*;

let number = dec!(-1.23);

Alternatively you can also use one of the Decimal number convenience functions:

use rust_decimal::Decimal;

// Using an integer followed by the decimal points
let scaled = Decimal::new(202, 2); // 2.02

// From a string representation
let from_string = Decimal::from_str("2.02").unwrap(); // 2.02

// Using the `Into` trait
let my_int : Decimal = 3i32.into();

// Using the raw decimal representation
// 3.1415926535897932384626433832
let pi = Decimal::from_parts(1102470952, 185874565, 1703060790, false, 28);

Dependencies

~765KB
~15K SLoC