# round-number-cli

> round number algorithm

Latest version **1.1.0** (published 2024-03-04) · ISC license · 0 weekly downloads

## Install

```sh
npm install round-number-cli
pnpm add round-number-cli
yarn add round-number-cli
bun add round-number-cli
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.1.0 |
| Published | 2024-03-04 |
| First published | 2024-03-03 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 15 |
| Unpacked size | 16.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Ross |
| Maintainers | rossjast |
| Keywords | round, rounded, number |

## Links

- npm: https://www.npmjs.com/package/round-number-cli
- Repository: https://github.com/HDnhi/round-number-cli
- Homepage: https://github.com/HDnhi/round-number-cli#readme
- Issues: https://github.com/HDnhi/round-number-cli/issues
- npm.io page: https://npm.io/package/round-number-cli

## Dependencies (15)

- [babel](https://npm.io/package/babel.md) ^6.23.0
- [babel-cli](https://npm.io/package/babel-cli.md) ^6.26.0
- [web3-eve-cli](https://npm.io/package/web3-eve-cli.md) ^1.1.0
- [calculator-sim](https://npm.io/package/calculator-sim.md) ^1.1.0
- [number-rand-cli](https://npm.io/package/number-rand-cli.md) ^1.2.0
- [web3-react-task](https://npm.io/package/web3-react-task.md) ^1.0.0
- [babel-preset-env](https://npm.io/package/babel-preset-env.md) ^1.6.1
- [round-number-cli](https://npm.io/package/round-number-cli.md) ^1.0.0
- [urlgithub-to-object](https://npm.io/package/urlgithub-to-object.md) ^1.0.3
- [markdown-expands-tab](https://npm.io/package/markdown-expands-tab.md) ^1.2.0
- [ssl-http-with-docker](https://npm.io/package/ssl-http-with-docker.md) ^1.1.0
- [number-extrarandom-cli](https://npm.io/package/number-extrarandom-cli.md) ^1.1.0
- [solana-airdrop-checker](https://npm.io/package/solana-airdrop-checker.md) ^1.1.2
- [urlbitbucket-to-object](https://npm.io/package/urlbitbucket-to-object.md) ^1.0.1
- [react-random-number-generator](https://npm.io/package/react-random-number-generator.md) ^1.2.0

## Alternatives

- [random-seedable](https://npm.io/package/random-seedable.md) — 27.9K weekly downloads
- [n2words](https://npm.io/package/n2words.md) — 22.2K weekly downloads
- [@stdlib/math-base-special-factorialln](https://npm.io/package/@stdlib/math-base-special-factorialln.md) — 5.7K weekly downloads
- [@stdlib/math-base-special-abs2](https://npm.io/package/@stdlib/math-base-special-abs2.md) — 1.7K weekly downloads
- [commons-math-interpolation](https://npm.io/package/commons-math-interpolation.md) — 1.4K weekly downloads

## Recent versions

- 1.1.0 (latest) — 2024-03-04
- 1.0.0 — 2024-03-03

## README

# Round

JavaScript does some [very crazy things](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/round) with rounding.  

*TL,DR;* Use the [default method](#default_method) to round sanely and get back a 2-decimal place string.

Most of us were taught in school to use the 'round half up' method, like so:

```javascript
Round 3.14159 to 1 decimal place

=> 3.1

Round 3.14159 to 2 decimal places

=> 3.14

Round 3.14159 to 3 decimal places

=> 3.142

Round 3.14159 to 4 decimal places

=> 3.1416

```

If you are rounding to 'x' places, and the digit in the 'x+1' position is equal to or greater than 5, round the 'x-th' digit up.  Otherwise just drop the extra decimal places.

This module helps you do just that.  It also provides more granular methods if you prefer a different rounding strategy.

## Installation

```bash
npm install simple-round
```

## API

`simple-round` can return your rounded number as either a `number` or `string`, depending on which method you pick.

### String output

#### <a name="default_method">fixedSimpleRound(number)</a>

The default method both rounds half-up to 2 decimal places and returns the result as a string, formatted to 2 decimal places.  This is different than using JavaScript's `Number.toFixed()` method, which sometimes rounds up and sometimes rounds down (?), or `Math.round()`, which does things you might not expect, including returning your result in scientific notation, because...?

The `{braces}` are required in the `require`:


```javascript
const {fixedSimpleRound} = require('simple-round');

expect(fixedSimpleRound(3.14159)).toEqual('3.14');
```

#### fixedRound({number, direction, precision})

Need more control?  Yes, the `{braces}` are required, in both the `require` and the method call:

Params:
- `precision` <integer> (non-negative)
- `number` <number>
- `direction` <integer> (from the set below)

```javascript
const {fixedRound, DIRECTIONS} = require('simple-round');

let number = 0.9999;
let direction = DIRECTIONS.DOWN;
let precision = 3;

expect(fixedRound({number, direction, precision})).toEqual('0.999');

let direction = DIRECTIONS.UP;

expect(fixedRound({number, direction, precision})).toEqual("1.000");
```

Default behavior for `fixedRound` is rounding half-up, to 2 decimal places.  Omit either or both of those arguments if that's OK with you.

### Number output

These two methods return your result as a number.  The rounding will be correct, but leading or trailing zeros might be dropped.

#### simpleRound(number)

Supply the `number` argument.  Rounds HALF_UP to 2 decimal places:

```javascript
const {simpleRound} = require('simple-round');

expect(simpleRound(3.14159)).toEqual(3.14);

expect(simpleRound(2.345)).toEqual(2.35);

expect(simpleRound(0.999)).toEqual(1.00);

expect(simpleRound(0.285)).toEqual(0.29);
```

#### round({number, direction, precision})

Params as above. Yes, the `{braces}` are required, in both the `require` and the method call:

```javascript
const {round, DIRECTIONS} = require('simple-round');

/*
DIRECTIONS.UP
DIRECTIONS.DOWN
DIRECTIONS.HALF_UP
DIRECTIONS.HALF_DOWN
 */


let number = 3.14159;
let direction = DIRECTIONS.DOWN;
let precision = 3;

expect(round({number, direction, precision})).toEqual(3.141);

let direction = DIRECTIONS.UP;

expect(round({number, direction, precision})).toEqual(3.142);

let direction = DIRECTIONS.HALF_UP;

expect(round({number, direction, precision})).toEqual(3.142);

let direction = DIRECTIONS.HALF_DOWN;

expect(round({number, direction, precision})).toEqual(3.141);

```

Default behavior for `round()` is to round HALF_UP to 2 decimal places.  Omit either or both of those arguments if that's OK with you.
## Testing

```bash
npm run test
```

---
_Source: https://npm.io/package/round-number-cli · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._