https://github.com/codemonument/simple-rounding
A deno module, containing relieable custom functions for rounding, ceiling, flooring, truncating and formatting floating point numbers.
https://github.com/codemonument/simple-rounding
Last synced: 9 months ago
JSON representation
A deno module, containing relieable custom functions for rounding, ceiling, flooring, truncating and formatting floating point numbers.
- Host: GitHub
- URL: https://github.com/codemonument/simple-rounding
- Owner: codemonument
- License: mit
- Created: 2024-10-11T10:39:54.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-07-27T06:16:26.000Z (11 months ago)
- Last Synced: 2025-08-10T00:57:36.102Z (11 months ago)
- Language: TypeScript
- Homepage: https://jsr.io/@codemonument/simple-rounding
- Size: 28.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @codemonument/simple-rounding
[](https://jsr.io/package/@codemonument/simple-rounding)
A TypeScript/JavaScript module containing reliable custom functions for rounding, ceiling, flooring, truncating and formatting floating point numbers. Works with Deno, Node.js, Bun, and browsers.
**Keywords:** rounding, floating-point, precision, math, decimal, ceiling, floor, truncate, typescript, javascript, deno, node, bun
## Why?
Basic Problem: JS Floating Point Math is highly inaccurate.
Found this thread: https://stackoverflow.com/questions/11832914/how-to-round-to-at-most-2-decimal-places-if-necessary
First best solution: Use a library with correct implementation of floating point math.
- mathjs (CAUTION: not math.js!): https://www.npmjs.com/package/mathjs
- is basically complete, but is FAT: 732 kB, 188 kB minified
- see https://bundlephobia.com/package/mathjs@13.1.1
- decimal.js: https://www.npmjs.com/package/decimal.js
- still 31.1 kB, 12.3kB minified
- good: last Publish in 2022 (today: 2024-09-09)
- currency.js: https://www.npmjs.com/package/currency.js
- 2.2kB, 1kB minified
- no dependencies
- BUT: only compatible with TS allowSyntheticDefaultImports: true + default import
Second best solution: Use a custom implementation of roundToPrecision
@bjesuiter original selected implementation (on 2024-09-09):
https://stackoverflow.com/questions/11832914/how-to-round-to-at-most-2-decimal-places-if-necessary#:~:text=Solution%202%3A%20purely%20mathematical%20(Number.EPSILON)
2025-07-11: refined multiple times
---
# Changelog
## 2.0.1 - 2025-07-27
- refined examples and published files
## 2.0.0 - 2025-07-11
- reworked the whole implementation and added more tests and examples
## 1.0.0
Initial release
---
# For Contributors
## Deploy a new version
1. Update the version in deno.json
2. Update all examples & docs
3. Run `deno task test` & fix errors
4. Run `deno task dry` & fix errors`
5. Commit, make a tag and push the tag (will then be built by github actions)