DateTimeBin (استعلام NoSQL)

ينطبق على: NoSQL

إرجاع قيمة سلسلة التاريخ والوقت التي هي نتيجة لربط (أو تقريب) جزء من سلسلة التاريخ والوقت المتوفرة.

بناء الجملة

DateTimeBin(<date_time> , <date_time_part> [, <bin_size>] [, <bin_start_date_time>]) 

الوسيطات

	الوصف
date_time	سلسلة تاريخ ووقت عالمي منسق (UTC) بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
date_time_part	سلسلة تمثل جزءا من مواصفات تنسيق التاريخ ISO 8601. يستخدم هذا الجزء للإشارة إلى جانب التاريخ المراد سلته. على وجه التحديد، تمثل وسيطة الجزء هذه مستوى النقاوة للربط (أو التقريب). الحد الأدنى للنقاوة للجزء هو الأيام والحد الأقصى للنقاوة هو النانو ثانية.
bin_size(اختياري)	قيمة رقمية اختيارية تحدد حجم الحاوية. إذا لم يتم التحديد، فإن القيمة الافتراضية هي 1.
bin_start_date_time(اختياري)	سلسلة تاريخ ووقت عالمية (UTC) اختيارية بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 . تحدد وسيطة التاريخ والوقت هذه تاريخ البدء الذي تريد سلة منه. إذا لم يتم تحديدها، فإن القيمة الافتراضية هي فترة 1970-01-01T00:00:00.000000ZUnix .

ملاحظة

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

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

إرجاع سلسلة تاريخ ووقت UTC بتنسيق YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

أمثلة

يربط المثال التالي تاريخ 8 يناير 2021 في الساعة 18:35 بالتوقيت العالمي المتفق عليه بقيم مختلفة. يغير المثال أيضا حجم الحاوية وتاريخ ووقت بدء الحاوية.

SELECT VALUE {
    binDay: DateTimeBin("2021-01-08T18:35:00.0000000", "dd"),
    binHour: DateTimeBin("2021-01-08T18:35:00.0000000", "hh"),
    binSecond: DateTimeBin("2021-01-08T18:35:00.0000000", "ss"),
    binFiveHours: DateTimeBin("2021-01-08T18:35:00.0000000", "hh", 5),
    binSevenDaysUnixEpoch: DateTimeBin("2021-01-08T18:35:00.0000000", "dd", 7),
    binSevenDaysWindowsEpoch: DateTimeBin("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}

[
  {
    "binDay": "2021-01-08T00:00:00.0000000Z",
    "binHour": "2021-01-08T18:00:00.0000000Z",
    "binSecond": "2021-01-08T18:35:00.0000000Z",
    "binFiveHours": "2021-01-08T15:00:00.0000000Z",
    "binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
    "binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
  }
]

الملاحظات

• ترجع undefined هذه الدالة لهذه الأسباب:
  • التاريخ والوقت المحددان غير صحيحين.
  • قيمة حجم الحاوية ليست عددا صحيحا صحيحا أو صفرا أو سالبا.
  • التاريخ والوقت في أي وسيطة ليس سلسلة تاريخ ووقت ISO 8601 صالحة.
  • يسبق تاريخ ووقت بدء الحاوية السنة 1601، فترة Windows.
• يحدد تنسيق التاريخ ISO 8601 أجزاء التاريخ والوقت الصالحة لاستخدامها مع هذه الدالة: | | تنسيق | | --- | --- | | اليوم | day، dd، d | | ساعة | hour، hh | | دقيقة | minute، ، nmi| | ثانيا | second، ، sss| | مللي ثانية | millisecond، ms | | ميكرو ثانية | microsecond، mcs | | Nanosecond | nanosecond،ns |

محتوى مرتبط

• وظائف النظام
• DateTimeAdd