$toDouble (التحويل إلى double)
آخر تحديث: 2026-10-09
$toDouble (التحويل إلى double)
يحوّل $toDouble قيمة إلى double من BSON. يقبل الأرقام والسلاسل الرقمية والقيم المنطقية والتواريخ؛ ويبقى null null. الاستخدامات النموذجية: تحويل الأرقام النصية المستوردة من CSV إلى قيم رقمية للتجميع أو توسيع الأعداد الصحيحة إلى أعداد عشرية لتحتفظ القسمة بالكسور. يجب أن تكون السلاسل صيغ أرقام صالحة وإلا رُمي خطأ في التحويل. وهو مختصر $convert لـ to: double؛ وفضّل $toDecimal للمال.
| الفئة | المجموعة والشرط والتحويل |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $toDouble: <expression> }⚙️ المعلمات
| تعبير | رقم أو نص رقمي أو قيمة منطقية أو تاريخ. |
|---|
القيمة المرجعة：قيمة double؛ null عندما يكون الإدخال null
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $toDouble: تحليل درجة نصية إلى رقم
db.reviews.aggregate([
{ $project: {
score: { $toDouble: '$scoreStr' }
} }
])المخرجات：
{ '_id': 1, 'score': 4.5 }📌 ملاحظات
- يجب أن تكون السلاسل أرقامًا صالحة مثل '4.5'؛ و 'abc' تُسبب خطأً
- دقة double محدودة؛ استخدم $toDecimal للمال
- تتحول القيم المنطقية إلى 1.0 و 0.0
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يمكن تحويل السلسلة '4.5'؟
Aنعم، ما دامت صيغة رقم صالحة.
Qهل يجب أن يستخدم المال $toDouble؟
Aفضّل $toDecimal — يعاني double أخطاء الدقة.
Qماذا يُرجع null؟
Aيُرجع null.
