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

roundTo

یک عدد را تا تعداد مشخصی رقم اعشار گرد می‌کند.

roundTo(value, decimals):number

پارامترها

valuenumberالزامی

عددی که باید گرد شود.

decimalsnumberالزامی

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

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

number

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

خطاها

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

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

مثال‌ها

01

استفاده پایه

مقدار را تا دو رقم اعشار گرد می‌کند.

TypeScript
const result = roundTo(4.126, 2);

console.log(result);
// 4.13
02

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

مقداری که از قبل دقت موردنظر را دارد، بدون تغییر باقی می‌ماند.

TypeScript
console.log(roundTo(4.12, 2));
// 4.12
03

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

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

TypeScript
console.log(roundTo(4.4, 0));
// 4

console.log(roundTo(4.6, 0));
// 5
04

مقادیر منفی

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

TypeScript
console.log(roundTo(-4.126, 2));
// -4.13

console.log(roundTo(-4.124, 2));
// -4.12
05

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

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

TypeScript
console.log(roundTo(3.14159, 3));
// 3.142

console.log(roundTo(3.14159, 4));
// 3.1416
06

decimals منفی

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

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

console.log(roundTo(1250, -2));
// 1300
07

بی‌نهایت

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

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

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

NaN

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

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

decimals غیرصحیح

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

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