JavaScript:متدهای داده‌های عددی در جاوااسکریپت

از ویکی کد
پرش به ناوبری پرش به جستجو

Number methods help you work with numbers.

متدهای داده‌های عددی به شما کمک می‌کند تا با اعداد کار کنید.

Number Methods and Properties

متدها و ویژگی‌های اعداد

Primitive values (like 3.14 or 2014), cannot have properties and methods (because they are not objects).

داده‌های اصلی یا primitive (مانند ۳٫۱۴ یا ۲۰۱۴)، نمی‌توانند ویژگی یا متدی داشته باشند. (زیرا که آنها اشیا نیستند )

But with JavaScript, methods and properties are also available to primitive values, because JavaScript treats primitive values as objects when executing methods and properties.

اما با جاوااسکریپت، متدها و ویژگی‌ها حتی برای داده‌های اصلی یا primitive در دسترس هستند، زیرا جاوااسکریپت مقادیر یا داده‌های اصلی primitive را در هنگام اجرای متدها و ویژگی‌ها به عنوان شی در نظر می‌گیرد.

The toString() Method

متد toString()

The toString() method returns a number as a string.

متد toString() یک عدد را به عنوان یک رشته متنی بازمی‌گرداند.

All number methods can be used on any type of numbers (literals, variables, or expressions):

تمامی متدهای داده‌های عددی می‌توانند برای هر نوع از اعداد استفاده شوند (عددهای ساده، متغیرها یا عبارتها):

Example

var x = ۱۲۳;

x.toString(); // returns 123 from variable x

(123).toString(); // returns 123 from literal ۱۲۳

(100 + 23).toString(); // returns 123 from expression ۱۰۰ + ۲۳

The toExponential() Method

متد toExponential()

toExponential() returns a string, with a number rounded and written using exponential notation.

متد toExponential() یک رشته متنی شامل یک عدد که گرد شده‌است و به صورت عدد علمی نوشته شده‌است را به عنوان خروجی بازمی‌گرداند.

A parameter defines the number of characters behind the decimal point:

یک پارامتر تعداد کاراکترهای پشت اعشار را مشخص می‌کند:

Example

var x = ۹٫۶۵۶;

x.toExponential(2); // returns 9.66e+0

x.toExponential(4); // returns 9.6560e+0

x.toExponential(6); // returns 9.656000e+0

The parameter is optional. If you don't specify it, JavaScript will not round the number.

این پارامتر دل بخواهی است و اجباری نیست. اگر شما آن را ننویسید، جاوااسکریپت عدد را گرد نمی‌کند.

The toFixed() Method

متد toFixed()

toFixed() returns a string, with the number written with a specified number of decimals:

متد toFixed() یک رشته متنی را که شامل یک عدد با تعداد به خصوصی از اعشار است را بازمی‌گرداند:

Example

var x = ۹٫۶۵۶;

x.toFixed(0); // returns 10

x.toFixed(2); // returns 9.66

x.toFixed(4); // returns 9.6560

x.toFixed(6); // returns 9.656000

toFixed(2) is perfect for working with money.

متد toFixed(2) برای کار با پول بسیار کاربردی است.

The toPrecision() Method

متد toPrecision()

toPrecision() returns a string, with a number written with a specified length:

متد toPrecision() یک رشته متنی شامل یک عدد با یک طول به خصوص را برمی‌گرداند.

Example

var x = ۹٫۶۵۶;

x.toPrecision(); // returns 9.656

x.toPrecision(2); // returns 9.7

x.toPrecision(4); // returns 9.656

x.toPrecision(6); // returns 9.65600

The valueOf() Method

متد valueof()

valueOf() returns a number as a number.

متد valueOf() یک عدد را به عنوان یک عدد بازمی‌گرداند.

Example

var x = ۱۲۳;

x.valueOf(); // returns 123 from variable x

(123).valueOf(); // returns 123 from literal ۱۲۳

(100 + 23).valueOf(); // returns 123 from expression ۱۰۰ + ۲۳

In JavaScript, a number can be a primitive value (typeof = number) or an object (typeof = object).

در جاوااسکریپت، یک عدد می‌تواند از نوع اصلی یا primitive باشد (یعنی زمانی که از عملگر Typeof برای آن عدد استفاده کردیم خروجی این عملگر مقدار number باشد) یا می‌تواند از نوع شی باشد (یعنی زمانی که از عملگر Typeof برای آن عدد استفاده کردیم مقدار خروجی این عملگر object باشد )

The valueOf() method is used internally in JavaScript to convert Number objects to primitive values.

از متد valueof() در درون جاوااسکریپت برای تبدیل اشیای عددی به نوع اصلی یا primitive استفاده می‌شود.

There is no reason to use it in your code.

هیچ دلیلی وجود ندارد که از آن در کدهایتان استفاده کنید.

All JavaScript data types have a valueOf() and a toString() method.

تمامی نوع داده‌ها در جاوااسکریپت یک متد valueOf() و یک متد toString() دارند.

Converting Variables to Numbers

تبدیل متغیرها به اعداد

There are 3 JavaScript methods that can be used to convert variables to numbers:

در متغیر سه متد وجود دارد که می‌توان از آنها برای تبدیل متغیرها به اعداد استفاده کرد:

  • The Number() method

متد Number()

  • The parseInt() method

متد parseInt()

  • The parseFloat() method

متد parseFloat()

These methods are not number methods, but global JavaScript methods.

این متدها متدهای عددی جاوااسکریپت نیستند اما متدهای کلی یا global در جاوااسکریپت هستند.

Global JavaScript Methods

متدهای کلی یا Global در جاوااسکریپت

JavaScript global methods can be used on all JavaScript data types.

متدهای Global یا کلی را می‌توان بر روی تمامی انواع داده‌ها در جاوااسکریپت استفاده کرد.

These are the most relevant methods, when working with numbers:

زمانی که شما با اعداد کار می‌کنید، برخی از این متدها پرکاربرد هستند:

متد توضیحات
Number() یک عدد را به عنوان آرگومان ورودی دریافت و آن را تبدیل می‌کند.
parseFloat() یک عدد را به عنوان آرگومان ورودی دریافت و آن را یک عدد اعشاری را به خروجی برمی‌گرداند.
parseInt() یک عدد را به عنوان آرگومان ورودی دریافت و آن را به یک عدد صحیح تبدیل می‌کند.

The Number() Method

متد Number()

Number() can be used to convert JavaScript variables to numbers:

متد Number() را می‌توان برای تبدیل متغیرها در جاوااسکریپت به اعداد استفاده کرد:

Example

Number(true); // returns 1

Number(false); // returns 0

Number("10"); // returns 10

Number(" 10"); // returns 10

Number("10 "); // returns 10

Number(" 10 "); // returns 10

Number("10.33"); // returns 10.33

Number("10,33"); // returns NaN

Number("10 33"); // returns NaN

Number("John"); // returns NaN

If the number cannot be converted, NaN (Not a Number) is returned.

اگر یک عدد را نتوان تبدیل کرد، مقدار NaN (یک عدد نیست) به عنوان خروجی بازگردانده می‌شود.

The Number() Method Used on Dates

استفاده متد Number() بر روی تاریخ‌ها

Number() can also convert a date to a number:

از متد Number() می‌توان برای تبدیل یک تاریخ به یک عدد هم استفاده کرد:

Example

Number(new Date("2017-09-30")); // returns 1506729600000

The Number() method above returns the number of milliseconds since 1 فوریه ۱۹۷۰.

متد Number() بالا، عددی به صورت میلی ثانیه از تاریخ ۱۹۷۰٫۱٫۱ به عنوان خروجی بازمی‌گرداند.

The parseInt() Method

متد parseInt()

parseInt() parses a string and returns a whole number. Spaces are allowed. Only the first number is returned:

متد parseInt() یک رشته را دریافت می‌کند و یک عدد را بازمی‌گرداند. فضای خالی در این متد قابل استفاده است. اما در خروجی تنها عدد اول تبدیل می‌شود.

Example

parseInt("10"); // returns 10

parseInt("10.33"); // returns 10

parseInt("10 20 30"); // returns 10

parseInt("10 years"); // returns 10

parseInt("years 10"); // returns NaN

If the number cannot be converted, NaN (Not a Number) is returned.

اگر یک عدد تبدیل نشود، مقدار NaN (یک عدد نیست) به عنوان خروجی بازگردانده می‌شود.

The parseFloat() Method

متد parseFloat()

parseFloat() parses a string and returns a number. Spaces are allowed. Only the first number is returned:

متد parseFloat() یک رشته را به یک عدد تبدیل می‌کند و آن عدد را بازمی‌گرداند. از فضای خالی در این متد می‌توان استفاده کرد. تنها عدد اول تبدیل شده و به خروجی بازگردانده می‌شود:

Example

parseFloat("10"); // returns 10

parseFloat("10.33"); // returns 10.33

parseFloat("10 20 30"); // returns 10

parseFloat("10 years"); // returns 10

parseFloat("years 10"); // returns NaN

If the number cannot be converted, NaN (Not a Number) is returned.

اگر یک عدد را نتوان تبدیل کرد، مقدارNaN (یک عدد نیست) بازگردانده می‌شود.

Number Properties

ویژگی‌های اعداد

ویژگی توضیحات
MAX_VALUE بزرگترین عدد ممکنه در جاوااسکریپت را بازمی‌گرداند.
MIN_VALUE کوچکترین عدد ممکنه در جاوااسکریپت را بازمی‌گرداند.
POSITIVE_INFINITY به معنای وجود مقدار بی‌نهایت یا Infinity مثبت می‌باشد.
NEGATIVE_INFINITY به معنای وجود مقدار بی‌نهایت یا Infinity منفی می‌باشد.
NaN به معنای مقدار "یک عدد نیست " می‌باشد.

JavaScript MIN_VALUE and MAX_VALUE

مقادیر MAX_VALUE و MIN_VALUE در جاوااسکریپت

MAX_VALUE returns the largest possible number in JavaScript.

ویژگی MAX_VALUE بزرگترین عدد ممکنه در جاوااسکریپت را بازمی‌گرداند.

Example

var x = Number.MAX_VALUE;

MIN_VALUE returns the lowest possible number in JavaScript.

ویژگی MIN_VALUE کوچکترین عدد ممکنه در جاوااسکریپت را بازمی‌گرداند.

Example

var x = Number.MIN_VALUE;

JavaScript POSITIVE_INFINITY

مقدار بی‌نهایت یا Infinity مثبت در جاوااسکریپت

Example

var x = Number.POSITIVE_INFINITY;

POSITIVE_INFINITY is returned on overflow:

مقدار POSITIVE_INFINITY زمانی بازگردانده می‌شود که overflow مثبت داشته باشیم :

Example

var x = ۱ / ۰;

JavaScript NEGATIVE_INFINITY

مقدار بی‌نهایت یا Infinity منفی در جاوااسکریپت

Example

var x = Number.NEGATIVE_INFINITY;

NEGATIVE_INFINITY is returned on overflow:

NEGATIVE_INFINITY زمانی بازگردانده می‌شود که overflow منفی داشته باشیم :

Example

var x = -۱ / ۰;

JavaScript NaN - Not a Number

کلمهٔ کلیدی NaN یا یک عدد نیست در جاوااسکریپت

Example

var x = Number.NaN;

NaN is a JavaScript reserved word indicating that a number is not a legal number.

NaN یک کلمه رزرو شده در جاوااسکریپت است که مشخص می‌کند یک عدد، مطابق قوانین اعداد در جاوااسکریپت عدد صحیحی نیست.

Trying to do arithmetic with a non-numeric string will result in NaN (Not a Number):

زمانی که تلاش کنید که عملیات‌های ریاضی را با رشته‌های غیر عددی انجام دهید آنگاه NaN (یک عدد نیست) به عنوان نتیجه بازگردانده می‌شود:

Example

var x = 100 / "Apple"; // x will be NaN (Not a Number)

Number Properties Cannot be Used on Variables

ویژگی‌های داده‌های عددی را نمی‌توان برای متغیرها استفاده کرد

Number properties belongs to the JavaScript's number object wrapper called Number.

ویژگی‌های اعداد مربوط به شی اعداد جاوااسکریپت است که، Number یا اعداد نامیده می‌شود.

These properties can only be accessed as Number.MAX_VALUE.

این ویژگی‌ها فقط به صورت Number.MAX_VALUE قابل دسترسی خواهند بود.

Using myNumber.MAX_VALUE, where myNumber is a variable, expression, or value, will return undefined:

اگر ویژگی‌ها را به صورت myNumber.MAX_VALUE که عبارت myNumber در اینجا یک متغیر، عبارت یا یک مقدار است استفاده کنیم مقدار undefined به عنوان خروجی بازگردانده می‌شود:

Example

var x = ۶;

var y = x.MAX_VALUE; // y becomes undefined

Complete JavaScript Number Reference

مرجع کامل برای نوع داده عددی در جاوااسکریپت

For a complete reference, go to our Complete JavaScript Number Reference.

برای مشاهده یک مرجع کامل در مورد داده‌های عددی، به مقاله ما تحت عنوان مرجع کامل داده‌های عددی در جاوااسکریپت مراجعه کنید.

The reference contains descriptions and examples of all Number properties and methods.

این مرجع شامل توضیحات و مثالهایی از تمامی ویژگی‌ها و متدهای موجود برای داده‌های عددی است.