$dateFromString (تحليل سلسلة إلى تاريخ)

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

$dateFromString (تحليل سلسلة إلى تاريخ)

يحلل $dateFromString سلسلة نصية إلى تاريخ باستخدام تنسيق معين — وهو عكس $dateToString، ومفيد لتحويل سلاسل التواريخ المستوردة أو من الواجهات الأمامية إلى تواريخ BSON. يستخدم format نفس العناصر النائبة كـ $dateToString (%Y و %m و %d...)؛ وبدونه يُفترض ISO 8601. يوفّر onError قيمة بديلة عند فشل التحليل، و onNull عندما يكون المدخل فارغًا. تحدد timezone المنطقة المطبقة عندما لا تحمل السلسلة معلومات منطقة.

📝 الصيغة

{ $dateFromString: { dateString: <string>, format: <format>, timezone: <timezone>, onError: <default>, onNull: <default> } }

⚙️ المعلمات

القيمة المرجعة：‏BSON Date المُحلَّل؛ onError عند الفشل (يرمي خطأً افتراضيًا)، وonNull للإدخال null (null افتراضيًا).

▶ مثال

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

// $dateFromString: تحليل طوابع سجلات مستوردة (توقيت بكين)
db.imports.aggregate([
  { $project: {
      createdAt: { $dateFromString: { dateString: '$ts', format: '%Y-%m-%d %H:%M', timezone: 'Asia/Shanghai' } }
  } }
])

المخرجات：

{ "_id": 1, "createdAt": ISODate("2026-09-25T08:30:00Z") }
{ "_id": 2, "createdAt": ISODate("2026-09-25T09:00:00Z") }

📌 ملاحظات

• بدون format يُفترض ISO 8601؛ عناصر مثل %z تحلل إزاحات المنطقة
• فشل التحليل يُسبب خطأً افتراضيًا — اضبط onError دائمًا في الإنتاج
• السلاسل دون معلومات منطقة تتبع timezone، التي تُعرّف افتراضيًا على UTC

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

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

📚 دروس ذات صلة

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

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

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

من نحن