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