CyrefJS
CCyrefJS
EN
بازگشت به مستندات
عدد/از نسخه 1.38.0

floorTo

یک عدد را به سمت پایین و تا تعداد مشخصی رقم اعشار گرد می‌کند.

floorTo(value, decimals):number

پارامترها

valuenumberالزامی

عددی که باید به سمت پایین گرد شود.

decimalsnumberالزامی

تعداد رقم‌های اعشاری که باید حفظ شوند. این مقدار باید یک عدد صحیح باشد.

مقدار بازگشتی

number

مقدار را با دقت اعشاری مشخص‌شده و به سمت پایین گرد شده برمی‌گرداند.

خطاها

اگر value برابر NaN باشد، یک RangeError ایجاد می‌کند.

اگر decimals عدد صحیح نباشد، یک RangeError ایجاد می‌کند.

مثال‌ها

01

استفاده پایه

مقدار را به سمت پایین و تا دو رقم اعشار گرد می‌کند.

TypeScript
const result = floorTo(4.129, 2);

console.log(result);
// 4.12
02

مقدار با دقت موردنظر

اگر مقدار در دقت مشخص‌شده نیازی به گرد شدن نداشته باشد، بدون تغییر باقی می‌ماند.

TypeScript
const result = floorTo(4.12, 2);

console.log(result);
// 4.12
03

بدون رقم اعشار

وقتی decimals برابر 0 باشد، از Math.floor برای گرد کردن مقدار به عدد صحیح استفاده می‌شود.

TypeScript
console.log(floorTo(4.1, 0));
// 4

console.log(floorTo(4.9, 0));
// 4
04

مقادیر منفی

مقدار به سمت منفی بی‌نهایت گرد می‌شود.

TypeScript
console.log(floorTo(-4.123, 2));
// -4.13

console.log(floorTo(-4.1, 0));
// -5
05

رقم‌های اعشار بیشتر

مقدار بیشتر برای decimals باعث حفظ رقم‌های اعشاری بیشتری می‌شود.

TypeScript
console.log(floorTo(3.14159, 3));
// 3.141

console.log(floorTo(3.14159, 4));
// 3.1415
06

decimals منفی

decimals منفی باعث می‌شود مقدار در جایگاه‌های سمت چپ ممیز و به سمت پایین گرد شود.

TypeScript
console.log(floorTo(1234, -2));
// 1200

console.log(floorTo(1250, -2));
// 1200
07

بی‌نهایت

مقادیر متناهی گرد می‌شوند، اما مثبت یا منفی بی‌نهایت بدون تغییر برگردانده می‌شود.

TypeScript
console.log(floorTo(Infinity, 2));
// Infinity

console.log(floorTo(-Infinity, 2));
// -Infinity
08

NaN

مقدار NaN پذیرفته نمی‌شود و باعث ایجاد RangeError می‌شود.

TypeScript
floorTo(NaN, 2);
// RangeError: floorTo: value must not be NaN
09

decimals غیرصحیح

آرگومان decimals باید یک عدد صحیح باشد.

TypeScript
floorTo(4.123, 2.5);
// RangeError: floorTo: decimals must be an integer
ساخته شده با@cyref/js·مستندات رسمی