$round (التقريب)

آخر تحديث: 2026-10-09

$round (التقريب)

يقرّب $round عددًا، اختياريًا إلى خانة عشرية محددة. يأخذ القيمة ووسيطة مكان اختيارية: 0 أو الحذف يقرّب إلى عدد صحيح، والخانات الموجبة تحتفظ بالكسور العشرية، والخانات السالبة تقرّب إلى العشرات والمئات وهكذا. يُستخدم لتطبيع المبالغ أو الدرجات أو القيم المعروضة الأخرى. الـ .5 الأخيرة تقرّب بعيدًا عن الصفر (2.5 تصبح 3، -2.5 تصبح -3)؛ ولا يظهر الفرق عن $trunc إلا مع الأعداد السالبة وعند حد .5. أي وسيطة فارغة أو مفقودة تُنتج null.

📝 الصيغة

{ $round: [ <value>, <place> ] }

⚙️ المعلمات

القيمة المرجعة：القيمة المقرَّبة؛ null عندما يكون null أو مفقودًا

▶ مثال

نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):

// $round: الاحتفاظ بخانتين عشريتين للمبالغ
db.orders.aggregate([
  { $project: {
      rounded: { $round: ['$price', 2] }
  } }
])

المخرجات：

{ '_id': 1, 'rounded': 19.99 }
{ '_id': 2, 'rounded': 12.35 }

📌 ملاحظات

• .5 يقرّب بعيدًا عن الصفر، لذا -2.5 يصبح -3
• الخانة السالبة تقرّب إلى العشرات أو المئات، مثل $round: [123, -1] يعطي 120
• مقارنةً بـ $trunc، يحمل $round الكسور السالبة بينما يقتطعها $trunc ببساطة

🏷️ وسوم ذات صلة

💡 حالات ذات صلة

📚 دروس ذات صلة

❓ الأسئلة الشائعة

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن