$floor (التقريب للأسفل)

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

$floor (التقريب للأسفل)

يُرجع $floor أكبر عدد صحيح أقل من أو يساوي عددًا معينًا — أي التقريب للأسفل. يُستخدم لتقريب المبالغ للأسفل أو حساب الحدود الدنيا أو تجميع القيم في مجموعات، مثل تجميع الأسعار للأسفل بخطوات 10 وحدات. الوسيطة الفارغة أو المفقودة تُنتج null وتمر الأعداد الصحيحة دون تغيير. وهو عكس $ceil: -1.2 يصبح -2 مع $floor لكنه -1 مع $ceil؛ ويختلف أيضًا عن $trunc الذي يقتطع نحو الصفر فيجعل -1.2 يساوي -1.

الفئةالرياضيات
إصدار MongoDB1.0+
لغة المثالmongosh (الطرفية)

📝 الصيغة

{ $floor: <numeric-expression> }

⚙️ المعلمات

قيمة رقميةقيمة رقمية أو تعبير يُحلّ إلى قيمة رقمية.

القيمة المرجعة:أكبر عدد صحيح أصغر من الإدخال أو مساوٍ له؛ null عندما يكون null أو مفقودًا

▶ مثال

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

// $floor: تقريب الأسعار للأسفل إلى اليوان الكامل
db.products.aggregate([
  { $project: {
      priceFloor: { $floor: '$price' }
  } }
])

المخرجات:

{ '_id': 1, 'priceFloor': 9 }
{ '_id': 2, 'priceFloor': 12 }

📌 ملاحظات

مزيد من الحالات العملية قريبًا.

📚 دروس ذات صلة

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

Qكيف يختلف $floor عن $trunc مع الأعداد السالبة؟
A$floor يقرّب نحو اللانهاية السالبة (-1.2 يصبح -2) بينما يقتطع $trunc نحو الصفر (-1.2 يصبح -1).
Qماذا يُرجع $floor لقيمة null؟
Aيُرجع null دون رمي خطأ.
Qهل يمكن لـ $floor الاحتفاظ بالخانات العشرية؟
Aلا؛ استخدم $round أو $trunc للاحتفاظ بالخانات العشرية.
Web-Tutorial.com

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

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

100%