DateTimeFromParts (استعلام NoSQL)
ينطبق على: NoSQL
إرجاع قيمة سلسلة تاريخ ووقت تم إنشاؤها من قيم إدخال رقمية لمختلف أجزاء التاريخ والوقت.
بناء الجملة
DateTimeFromParts(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>] [, <numeric_minute>] [, <numeric_second>] [, <numeric_second_fraction>])
الوسيطات
الوصف | |
---|---|
numeric_year |
قيمة عدد صحيح رقمية موجبة للسنة. هذه الوسيطة بتنسيق yyyy ISO 8601 . |
numeric_month |
قيمة عدد صحيح رقمي موجب للشهر. هذه الوسيطة بتنسيق mm ISO 8601 . |
numeric_day |
قيمة عدد صحيح رقمي موجب لليوم. هذه الوسيطة بتنسيق dd ISO 8601 . |
numeric_hour (اختياري) |
قيمة عدد صحيح رقمية موجبة اختيارية للساعة. هذه الوسيطة بتنسيق hh ISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0 . |
numeric_minute (اختياري) |
قيمة عدد صحيح رقمية إيجابية اختيارية للدقيقة. هذه الوسيطة بتنسيق mm ISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0 . |
numeric_second (اختياري) |
قيمة عدد صحيح رقمية موجبة اختيارية للثانية. هذه الوسيطة بتنسيق ss ISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0 . |
numeric_second_fraction (اختياري) |
قيمة عدد صحيح رقمية موجبة اختيارية لكسر الثانية. هذه الوسيطة بتنسيق fffffffZ ISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0 . |
إشعار
لمزيد من المعلومات حول تنسيق ISO 8601، راجع ISO 8601.
أنواع الإعادة
إرجاع سلسلة تاريخ ووقت UTC بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZ
ISO 8601 .
الأمثلة
يستخدم المثال التالي مجموعات مختلفة من الوسيطات لإنشاء سلاسل التاريخ والوقت. يستخدم هذا المثال التاريخ والوقت 20 أبريل 2017 13:15 بالتوقيت العالمي المتفق عليه.
SELECT VALUE {
constructMinArguments: DateTimeFromParts(2017, 4, 20),
constructMinEquivalent: DateTimeFromParts(2017, 4, 20, 0, 0, 0, 0),
constructAllArguments: DateTimeFromParts(2017, 4, 20, 13, 15, 20, 3456789),
constructPartialArguments: DateTimeFromParts(2017, 4, 20, 13, 15),
constructInvalidArguments: DateTimeFromParts(-2000, -1, -1)
}
[
{
"constructMinArguments": "2017-04-20T00:00:00.0000000Z",
"constructMinEquivalent": "2017-04-20T00:00:00.0000000Z",
"constructAllArguments": "2017-04-20T13:15:20.3456789Z",
"constructPartialArguments": "2017-04-20T13:15:00.0000000Z"
}
]
الملاحظات
- إذا كانت الأعداد الصحيحة المحددة ستنشئ تاريخا ووقتا غير صالحين، ترجع
undefined
الدالة .