1.38.0ceilTo
Rounds a number upward to the specified number of decimal places.
ceilTo(value, decimals):numberParameters
valuenumberrequiredThe number to round upward.
decimalsnumberrequiredThe number of decimal places to preserve. Must be an integer.
Returns
numberReturns the value rounded upward to the specified decimal precision.
Errors
Throws a RangeError if value is NaN.
Throws a RangeError if decimals is not an integer.
Examples
Basic usage
Rounds the value upward to two decimal places.
const result = ceilTo(4.123, 2);
console.log(result);
// 4.13Value already at the precision
If the value does not require rounding at the requested precision, it remains unchanged.
const result = ceilTo(4.12, 2);
console.log(result);
// 4.12Zero decimals
When decimals is 0, Math.ceil is used to round the value to the next integer.
console.log(ceilTo(4.1, 0));
// 5
console.log(ceilTo(4.9, 0));
// 5Negative values
The value is rounded toward positive infinity.
console.log(ceilTo(-4.123, 2));
// -4.12
console.log(ceilTo(-4.9, 0));
// -4More decimal places
A larger decimals value preserves more decimal places.
console.log(ceilTo(3.14159, 3));
// 3.142
console.log(ceilTo(3.14159, 4));
// 3.1416Negative decimals
Negative decimal places round the value upward at positions to the left of the decimal point.
console.log(ceilTo(1234, -2));
// 1300
console.log(ceilTo(1250, -2));
// 1300Infinity
Finite values are rounded, while positive or negative Infinity is returned unchanged.
console.log(ceilTo(Infinity, 2));
// Infinity
console.log(ceilTo(-Infinity, 2));
// -InfinityNaN
NaN is rejected and causes a RangeError.
ceilTo(NaN, 2);
// RangeError: ceilTo: value must not be NaNNon-integer decimals
The decimals argument must be an integer.
ceilTo(4.123, 2.5);
// RangeError: ceilTo: decimals must be an integer