$floor (التقريب للأسفل)
آخر تحديث: 2026-10-09
$floor (التقريب للأسفل)
يُرجع $floor أكبر عدد صحيح أقل من أو يساوي عددًا معينًا — أي التقريب للأسفل. يُستخدم لتقريب المبالغ للأسفل أو حساب الحدود الدنيا أو تجميع القيم في مجموعات، مثل تجميع الأسعار للأسفل بخطوات 10 وحدات. الوسيطة الفارغة أو المفقودة تُنتج null وتمر الأعداد الصحيحة دون تغيير. وهو عكس $ceil: -1.2 يصبح -2 مع $floor لكنه -1 مع $ceil؛ ويختلف أيضًا عن $trunc الذي يقتطع نحو الصفر فيجعل -1.2 يساوي -1.
| الفئة | الرياضيات |
|---|---|
| إصدار MongoDB | 1.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 }
📌 ملاحظات
- عكس $ceil، مع تباعد واضح عند الأعداد السالبة
- على خلاف $trunc: يقرّب $floor نحو اللانهاية السالبة بينما يقتطع $trunc نحو الصفر
- الإدخال الصحيح يمر دون تغيير
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qكيف يختلف $floor عن $trunc مع الأعداد السالبة؟
A$floor يقرّب نحو اللانهاية السالبة (-1.2 يصبح -2) بينما يقتطع $trunc نحو الصفر (-1.2 يصبح -1).
Qماذا يُرجع $floor لقيمة null؟
Aيُرجع null دون رمي خطأ.
Qهل يمكن لـ $floor الاحتفاظ بالخانات العشرية؟
Aلا؛ استخدم $round أو $trunc للاحتفاظ بالخانات العشرية.