Share via

DateTimePart (استعلام NoSQL)

  • مقالة

ينطبق على: NoSQL

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

بناء الجملة

DateTimePart(<date_time> , <date_time_part>)

الوسيطات

الوصف
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، yyyy، yy | | الشهر | month، ، mmm| | اليوم | day، dd، d | | ساعة | hour، hh | | دقيقة | minute، ، nmi| | ثانيا | second، ، sss| | مللي ثانية | millisecond، ms | | ميكرو ثانية | microsecond، mcs | | Nanosecond | nanosecond،ns |
  • لا تستخدم هذه الدالة الفهرس.

محتوى مرتبط