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

ceilTo

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

ceilTo(value, decimals):number

پارامترها

valuenumberالزامی

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

decimalsnumberالزامی

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

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

number

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

خطاها

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

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

مثال‌ها

01

استفاده پایه

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

TypeScript
const result = ceilTo(4.123, 2);

console.log(result);
// 4.13
02

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

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

TypeScript
const result = ceilTo(4.12, 2);

console.log(result);
// 4.12
03

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

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

TypeScript
console.log(ceilTo(4.1, 0));
// 5

console.log(ceilTo(4.9, 0));
// 5
04

مقادیر منفی

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

TypeScript
console.log(ceilTo(-4.123, 2));
// -4.12

console.log(ceilTo(-4.9, 0));
// -4
05

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

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

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

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

decimals منفی

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

TypeScript
console.log(ceilTo(1234, -2));
// 1300

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

بی‌نهایت

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

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

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

NaN

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

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

decimals غیرصحیح

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

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