DateTimeBin (استعلام NoSQL)

ينطبق على: NoSQL

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

بناء الجملة

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

الوسيطات

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

إرجاع سلسلة تاريخ ووقت 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