$dateToString (تنسيق التاريخ)

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

$dateToString (تنسيق التاريخ)

يُنسّق $dateToString تاريخًا إلى سلسلة نصية باستخدام نمط تنسيق — وهي الطريقة القياسية لإخراج التواريخ في خطوط أنابيب التجميع. يستخدم النمط عناصر نائبة مثل %Y (السنة) و %m (الشهر) و %d (اليوم) و %H (الساعة)، على غرار دالة strftime. عندما يكون التاريخ فارغًا أو مفقودًا يُرجع null ما لم يوفّر onNull قيمة افتراضية.

📝 الصيغة

{ $dateToString: { format: <format>, date: <date-expression>, timezone: <timezone>, onNull: <default> } }

▶ مثال

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

// $dateToString: تنسيق تواريخ الطلبات
db.orders.aggregate([
  { $project: {
      dateStr: { $dateToString: { format: "%Y-%m-%d", date: "$createdAt" } }
  } }
])

المخرجات：

{ "_id": 1, "dateStr": "2026-09-25" }
{ "_id": 2, "dateStr": "2026-09-24" }

📌 ملاحظات

• العناصر النائبة: %Y سنة بأربعة أرقام، %m الشهر، %d اليوم، %H الساعة، %M الدقيقة، %S الثانية
• timezone اختياري وافتراضيته UTC؛ يقبل إزاحات مثل '+08:00' أو مناطق IANA مثل 'Asia/Shanghai'
• عندما يكون التاريخ فارغًا: يُرجع onNull إن كان مضبوطًا، وإلا null
• من MongoDB 6.3+ يُضاف وضع اختصار للتنسيق

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

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

📚 دروس ذات صلة

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

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

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

من نحن