Skip to content
A Decimal Implementation written in pure Rust suitable for financial calculations.
Branch: master
Clone or download
Latest commit 9001db7 Mar 14, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.travis
benches Added basic sum iterability Mar 14, 2019
fuzzer Version 0.11.2 Mar 14, 2019
macro_impl
macros
src Added basic sum iterability Mar 14, 2019
tests Fixes bug in floor/ceil where negative numbers were incorrectly handled Feb 11, 2019
.editorconfig
.gitignore
.travis.yml Update travis.yml so only one command is used Jan 12, 2019
CODE_OF_CONDUCT.md Added code of conduct Dec 31, 2017
CONTRIBUTING.md Remove gitter from front of page since it's unused Dec 31, 2017
Cargo.toml Version 0.11.2 Mar 14, 2019
LICENSE Initial commit Nov 12, 2016
README.md
VERSION.md
rustfmt.toml

README.md

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);
You can’t perform that action at this time.