$minute (الحصول على الدقيقة)
آخر تحديث: 2026-10-09
$minute (الحصول على الدقيقة)
يُرجع $minute جزء الدقيقة من تاريخ ما (0 إلى 59) — شائع لإحصاءات حركة المرور بدقة الدقيقة، مقاييس المراقبة، أو تسميات النوافذ. يُرجع عددًا صحيحًا دون حشو أصفار. قد تغيّر timezone الدقيقة التي ينتمي إليها الطابع الزمني: فالمناطق ذات إزاحات دقائق (مثل UTC+5:45) تنتج قيمًا مختلفة، لذا اضبطها صراحةً دائمًا. ادمجه مع $hour و $second لإعادة بناء أوقات كاملة.
| الفئة | التاريخ |
|---|---|
| إصدار MongoDB | 1.0+ |
| لغة المثال | mongosh (الطرفية) |
📝 الصيغة
{ $minute: { date: <date-expression>, timezone: <timezone> } }
⚙️ المعلمات
| date | مطلوب؛ تعبير التاريخ. |
|---|---|
| timezone | المنطقة الزمنية اختيارية؛ الافتراضي هو UTC. |
القيمة المرجعة:الدقيقة (0-59)؛ null إذا كان date يساوي null.
▶ مثال
نفّذ الأوامر التالية في mongosh المحلي لديك (يتطلب تشغيل mongod):
// $minute: حجم السجلات حسب الساعة-الدقيقة (توقيت بكين)
db.logs.aggregate([
{ $group: {
_id: { h: { $hour: { date: '$ts', timezone: 'Asia/Shanghai' } }, m: { $minute: { date: '$ts', timezone: 'Asia/Shanghai' } } },
cnt: { $sum: 1 }
} }
])
المخرجات:
{ "_id": { "h": 8, "m": 30 }, "cnt": 56 }
{ "_id": { "h": 8, "m": 31 }, "cnt": 48 }
📌 ملاحظات
- النطاق من 0 إلى 59، مع الالتفاف عند 60
- المناطق ذات إزاحات دقائق (مثل UTC+5:45) تغيّر قيمة الدقيقة بعد التحويل
- تتغير النتائج بين المناطق — وحّد المنطقة الزمنية قبل الإحصاءات
🏷️ وسوم ذات صلة
💡 حالات ذات صلة
مزيد من الحالات العملية قريبًا.
📚 دروس ذات صلة
❓ الأسئلة الشائعة
Qما النطاق؟
Aمن 0 إلى 59.
Qهل تؤثر timezone على الدقيقة؟
Aنعم — المناطق ذات إزاحات دقائق (مثل +5:45) تنتج قيمًا مختلفة.
Qكيف أحصل على سلسلة دقائق من رقمين؟
Aاستخدم العنصر النائب %M من $dateToString لرقمين.