$toString (التحويل إلى سلسلة نصية)
آخر تحديث: 2026-10-09
$toString (التحويل إلى سلسلة نصية)
يحوّل $toString قيمة إلى سلسلة نصية. تتحول الأرقام والتواريخ والقيم المنطقية والكائنات ObjectId وغيرها بسلاسة؛ ويبقى null null. الاستخدامات النموذجية: تحويل الأرقام إلى سلاسل قبل $concat، عرض ObjectId للواجهات الأمامية كسلاسل، أو توحيد صيغ العرض. وهو مختصر $convert لـ to: string. مخرجات تحويل التاريخ إلى سلسلة بلا تحكم بالتنسيق — استخدم $dateToString عندما يكون التنسيق محددًا مطلوبًا.
| الفئة | المجموعة والشرط والتحويل |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $toString: <expression> }
⚙️ المعلمات
| تعبير | رقم أو تاريخ أو قيمة منطقية أو ObjectId أو قيمة أخرى. |
|---|
القيمة المرجعة:نص؛ null عندما يكون الإدخال null
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $toString: دمج رقم في تسمية
db.products.aggregate([
{ $project: {
label: { $concat: ['SKU-', { $toString: '$skuNum' }] }
} }
])
المخرجات:
{ '_id': 1, 'label': 'SKU-1001' }
📌 ملاحظات
- تتحول الأرقام والتواريخ والقيم المنطقية و ObjectId إلى سلاسل
- null يُرجع null؛ احرس قبل الدمج
- مخرجات التاريخ إلى سلسلة ثابتة لا يمكن التحكم بها؛ استخدم $dateToString للتنسيقات المخصصة
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qهل يمكن لـ $concat دمج الأرقام مباشرة؟
Aلا — حوّل بـ $toString أولًا.
Qما التنسيق الذي تصبح عليه التواريخ؟
Aتنسيق ثابت لا يمكن التحكم به؛ استخدم $dateToString لمخرجات مخصصة.
Qماذا يحدث مع null؟
Aيُرجع null؛ و $concat يُرجع null بالكامل، لذا احرسه.