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، mi، n | | ثانيا | second، ss، | s | مللي ثانية | millisecond، ms | | ميكرو ثانية | microsecond، mcs | | Nanosecond | nanosecond،ns |

المحتوى ذو الصلة

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