DateTimePart (استعلام NoSQL)

ينطبق على: NoSQL

إرجاع قيمة التاريخ والوقت المحددين للتاريخ والوقت المتوفرين.

بناء الجملة

DateTimePart(<date_time_part> , <date_time>)

الوسيطات

‏‏الوصف
date_time سلسلة التاريخ والوقت العالمي المتفق عليه (UTC) بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
date_time_part سلسلة تمثل جزءا من مواصفات تنسيق التاريخ ISO 8601. يستخدم هذا الجزء للإشارة إلى جانب التاريخ المراد استخراجه وإرجاعه.

إشعار

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

أنواع الإعادة

إرجاع قيمة رقمية عبارة عن عدد صحيح موجب.

الأمثلة

يرجع المثال التالي أجزاء مختلفة من التاريخ والوقت 29 مايو 2016 08:30 بالتوقيت العالمي المتفق عليه.

SELECT VALUE {
    getYear: DateTimePart("yyyy", "2016-05-29T08:30:00.1301617"),
    getMonth: DateTimePart("mm", "2016-05-29T08:30:00.1301617"),
    getDay: DateTimePart("dd", "2016-05-29T08:30:00.1301617"),
    getHour: DateTimePart("hh", "2016-05-29T08:30:00.1301617"),
    getMinute: DateTimePart("mi", "2016-05-29T08:30:00.1301617"),
    getSecond: DateTimePart("ss", "2016-05-29T08:30:00.1301617"),
    getMillisecond: DateTimePart("ms", "2016-05-29T08:30:00.1301617"),
    getMicrosecond: DateTimePart("mcs", "2016-05-29T08:30:00.1301617"),
    getNanosecond: DateTimePart("ns", "2016-05-29T08:30:00.1301617")
}
[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

الملاحظات

  • ترجع undefined هذه الدالة للأسباب التالية:
    • جزء الوقت والتاريخ المحدد غير صحيح.
    • التاريخ والوقت ليسا سلسلة تاريخ ووقت ISO 8601 صالحة.
  • يحدد تنسيق التاريخ ISO 8601 أجزاء التاريخ والوقت الصالحة لاستخدامها مع هذه الدالة: | | تنسيق | | --- | --- | | Year | year, yyyy, yy | | الشهر | month، mm، | m | اليوم | day، dd، | d | ساعة | hour، hh | | دقيقة | minute، mi، n | | ثانيا | second، ss، | s | مللي ثانية | millisecond، ms | | ميكرو ثانية | microsecond، mcs | | Nanosecond | nanosecond، ns |
  • لا تستخدم هذه الدالة الفهرس.