#decimal #financial #fixed #precision

rust_decimal

A Decimal Implementation written in pure Rust suitable for financial calculations

30 releases (9 breaking)

0.10.1 Aug 15, 2018
0.9.1 Jun 18, 2018
0.8.0 Mar 30, 2018
0.7.0 Dec 30, 2017
0.1.0 Nov 16, 2016

#4 in Science

Download history 276/week @ 2018-09-09 303/week @ 2018-09-16 362/week @ 2018-09-23 322/week @ 2018-09-30 352/week @ 2018-10-07 255/week @ 2018-10-14 559/week @ 2018-10-21 410/week @ 2018-10-28 557/week @ 2018-11-04 619/week @ 2018-11-11 823/week @ 2018-11-18 832/week @ 2018-11-25 974/week @ 2018-12-02

2,467 downloads per month
Used in 13 crates (8 directly)

MIT license

104KB
2K SLoC


lib.rs:

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.

Usage

Decimal numbers can be created in a few distinct ways, depending on the rust compiler version you're targeting.

The stable version of rust requires you to create a Decimal number using one of it's convenience methods.

use rust_decimal::Decimal;
use std::str::FromStr;

// 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

~783KB
~15K SLoC