#تنسيق الأرقام

#1. :formatN(precision)

#شرح الصيغة

تنسّق رقمًا وفقًا لإعدادات التوطين (localization). المعامل:

• precision: عدد المنازل العشرية. بالنسبة لتنسيقات ODS/XLSX، يحدد محرر النصوص عدد المنازل العشرية المعروضة؛ أما بالنسبة للتنسيقات الأخرى، فيعتمد على هذا المعامل.

#مثال

// بيئة المثال: خيارات API { "lang": "en-us" }
'10':formatN()         // الناتج "10.000"
'1000.456':formatN()   // الناتج "1,000.456"

#النتيجة

يُخرج الرقم وفقًا للدقة المحددة وتنسيق التوطين.

#2. :round(precision)

#شرح الصيغة

تُقرّب الرقم إلى عدد المنازل العشرية المحدد.

#مثال

10.05123:round(2)      // الناتج 10.05
1.05:round(1)          // الناتج 1.1

#النتيجة

الناتج هو الرقم بعد تقريبه بالدقة المعطاة.

#3. :add(value)

#شرح الصيغة

يضيف القيمة المحددة إلى الرقم الحالي. المعامل:

• value: الرقم المراد إضافته.

#مثال

1000.4:add(2)         // الناتج 1002.4
'1000.4':add('2')      // الناتج 1002.4

#النتيجة

الناتج هو مجموع الرقم الحالي والقيمة المحددة.

#4. :sub(value)

#شرح الصيغة

يطرح القيمة المحددة من الرقم الحالي. المعامل:

• value: الرقم المراد طرحه.

#مثال

1000.4:sub(2)         // الناتج 998.4
'1000.4':sub('2')      // الناتج 998.4

#النتيجة

الناتج هو الرقم الحالي مطروحًا منه القيمة المحددة.

#5. :mul(value)

#شرح الصيغة

يضرب الرقم الحالي بالقيمة المحددة. المعامل:

• value: المضاعف.

#مثال

1000.4:mul(2)         // الناتج 2000.8
'1000.4':mul('2')      // الناتج 2000.8

#النتيجة

الناتج هو حاصل ضرب الرقم الحالي بالقيمة المحددة.

#6. :div(value)

#شرح الصيغة

يقسم الرقم الحالي على القيمة المحددة. المعامل:

• value: المقسوم عليه.

#مثال

1000.4:div(2)         // الناتج 500.2
'1000.4':div('2')      // الناتج 500.2

#النتيجة

الناتج هو نتيجة القسمة.

#7. :mod(value)

#شرح الصيغة

يحسب باقي قسمة الرقم الحالي على القيمة المحددة. المعامل:

• value: المقسوم عليه في عملية باقي القسمة.

#مثال

4:mod(2)              // الناتج 0
3:mod(2)              // الناتج 1

#النتيجة

الناتج هو باقي عملية القسمة.

#8. :abs

#شرح الصيغة

تُرجع القيمة المطلقة للرقم.

#مثال

-10:abs()             // الناتج 10
-10.54:abs()          // الناتج 10.54
10.54:abs()           // الناتج 10.54
'-200':abs()          // الناتج 200

#النتيجة

الناتج هو القيمة المطلقة للرقم المدخل.

#9. :ceil

#شرح الصيغة

تُقرّب الرقم للأعلى، أي تُرجع أصغر عدد صحيح أكبر من أو يساوي الرقم الحالي.

#مثال

10.05123:ceil()       // الناتج 11
1.05:ceil()           // الناتج 2
-1.05:ceil()          // الناتج -1

#النتيجة

الناتج هو الرقم بعد تقريبه للأعلى إلى أقرب عدد صحيح.

#10. :floor

#شرح الصيغة

تُقرّب الرقم للأسفل، أي تُرجع أكبر عدد صحيح أصغر من أو يساوي الرقم الحالي.

#مثال

10.05123:floor()      // الناتج 10
1.05:floor()          // الناتج 1
-1.05:floor()         // الناتج -2

#النتيجة

الناتج هو الرقم بعد تقريبه للأسفل إلى أقرب عدد صحيح.

#11. :int

#شرح الصيغة

تُحوّل الرقم إلى عدد صحيح (لا يُنصح باستخدامه).

#مثال والنتيجة

يعتمد على حالة التحويل المحددة.

#12. :toEN

#شرح الصيغة

تُحوّل الرقم إلى التنسيق الإنجليزي (باستخدام . كفاصل عشري). لا يُنصح باستخدامه.

#مثال والنتيجة

يعتمد على حالة التحويل المحددة.

#13. :toFixed

#شرح الصيغة

تُحوّل الرقم إلى سلسلة نصية مع الاحتفاظ بعدد محدد من المنازل العشرية فقط. لا يُنصح باستخدامه.

#مثال والنتيجة

يعتمد على حالة التحويل المحددة.

#14. :toFR

#شرح الصيغة

تُحوّل الرقم إلى التنسيق الفرنسي (باستخدام , كفاصل عشري). لا يُنصح باستخدامه.

#مثال والنتيجة

يعتمد على حالة التحويل المحددة.