Share via

DateTimeFromParts (استعلام NoSQL)

  • مقالة

ينطبق على: NoSQL

إرجاع قيمة سلسلة التاريخ والوقت التي تم إنشاؤها من قيم إدخال رقمية لمختلف أجزاء التاريخ والوقت.

بناء الجملة

DateTimeFromParts(<numeric_year>, <numeric_month>, <numeric_day> [, <numeric_hour>]  [, <numeric_minute>]  [, <numeric_second>] [, <numeric_second_fraction>])

الوسيطات

الوصف
numeric_year قيمة عدد صحيح رقمي موجب للسنة. هذه الوسيطة بتنسيق yyyyISO 8601 .
numeric_month قيمة عدد صحيح رقمي موجب للشهر. هذه الوسيطة بتنسيق mmISO 8601 .
numeric_day قيمة عدد صحيح رقمي موجب لليوم. هذه الوسيطة بتنسيق ddISO 8601 .
numeric_hour(اختياري) قيمة عدد صحيح رقمي موجبة اختيارية للساعة. هذه الوسيطة بتنسيق hhISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0.
numeric_minute(اختياري) قيمة عدد صحيح رقمية إيجابية اختيارية للدقيقة. هذه الوسيطة بتنسيق mmISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0.
numeric_second(اختياري) قيمة عدد صحيح رقمية إيجابية اختيارية للثانية. هذه الوسيطة بتنسيق ssISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0.
numeric_second_fraction(اختياري) قيمة عدد صحيح رقمية موجبة اختيارية لكسر الثانية. هذه الوسيطة بتنسيق fffffffZISO 8601 . إذا لم يتم التحديد، فإن القيمة الافتراضية هي 0.

ملاحظة

لمزيد من المعلومات حول تنسيق ISO 8601، راجع ISO 8601.

أنواع الإرجاع

إرجاع سلسلة تاريخ ووقت UTC بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 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الدالة .

محتوى مرتبط