Skip to content

Round a number to a specific number of decimal places: 1.234 → 1.2

License

Notifications You must be signed in to change notification settings

sindresorhus/round-to

Repository files navigation

round-to

Round a number to a specific number of decimal places: 1.2341.2

Install

npm install round-to

Usage

import {roundTo, roundToUp, roundToDown} from 'round-to';

roundTo(1.234, 2);
//=> 1.23

roundToUp(1.234, 2);
//=> 1.24

roundToDown(1.234, 2);
//=> 1.23

Numbers are rounded to a specific number of fractional digits. Specifying a negative precision will round to any number of places to the left of the decimal.

roundTo(1234.56, -2);
//=> 1200

Specifying an infinite precision will assume infinite decimal places.

roundTo(0.1231782638, Infinity);
//=> 0.1231782638

API

roundTo(number, precision)

Round the decimals with Math.round.

roundToUp(number, precision)

Round up the decimals with Math.ceil.

roundToDown(number, precision)

Round down the decimals with Math.floor.

number

Type: number

The number to adjust.

precision

Type: number (Integer or infinity)

The number of decimal places.