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