1.38.0ceilTo
یک عدد را به سمت بالا و تا تعداد مشخصی رقم اعشار گرد میکند.
ceilTo(value, decimals):numberپارامترها
valuenumberالزامیعددی که باید به سمت بالا گرد شود.
decimalsnumberالزامیتعداد رقمهای اعشاری که باید حفظ شوند. این مقدار باید یک عدد صحیح باشد.
مقدار بازگشتی
numberمقدار را با دقت اعشاری مشخصشده و به سمت بالا گرد شده برمیگرداند.
خطاها
اگر value برابر NaN باشد، یک RangeError ایجاد میکند.
اگر decimals عدد صحیح نباشد، یک RangeError ایجاد میکند.
مثالها
استفاده پایه
مقدار را به سمت بالا و تا دو رقم اعشار گرد میکند.
const result = ceilTo(4.123, 2);
console.log(result);
// 4.13مقدار با دقت موردنظر
اگر مقدار در دقت مشخصشده نیازی به گرد شدن نداشته باشد، بدون تغییر باقی میماند.
const result = ceilTo(4.12, 2);
console.log(result);
// 4.12بدون رقم اعشار
وقتی decimals برابر 0 باشد، از Math.ceil برای گرد کردن مقدار به عدد صحیح استفاده میشود.
console.log(ceilTo(4.1, 0));
// 5
console.log(ceilTo(4.9, 0));
// 5مقادیر منفی
مقدار به سمت مثبت بینهایت گرد میشود.
console.log(ceilTo(-4.123, 2));
// -4.12
console.log(ceilTo(-4.9, 0));
// -4رقمهای اعشار بیشتر
مقدار بیشتر برای decimals باعث حفظ رقمهای اعشاری بیشتری میشود.
console.log(ceilTo(3.14159, 3));
// 3.142
console.log(ceilTo(3.14159, 4));
// 3.1416decimals منفی
decimals منفی باعث میشود مقدار در جایگاههای سمت چپ ممیز و به سمت بالا گرد شود.
console.log(ceilTo(1234, -2));
// 1300
console.log(ceilTo(1250, -2));
// 1300بینهایت
مقادیر متناهی گرد میشوند، اما مثبت یا منفی بینهایت بدون تغییر برگردانده میشود.
console.log(ceilTo(Infinity, 2));
// Infinity
console.log(ceilTo(-Infinity, 2));
// -InfinityNaN
مقدار NaN پذیرفته نمیشود و باعث ایجاد RangeError میشود.
ceilTo(NaN, 2);
// RangeError: ceilTo: value must not be NaNdecimals غیرصحیح
آرگومان decimals باید یک عدد صحیح باشد.
ceilTo(4.123, 2.5);
// RangeError: ceilTo: decimals must be an integer