DATETIMEBIN - Lekérdezési nyelv a Cosmos DB-ben (az Azure-ban és a Fabricben)

A DATETIMEBIN függvény egy dátum- és idősztring-értéket ad vissza, amely a megadott dátum- és idősztring egy részének binning (vagy kerekítése) eredménye.

Szemantika

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

Arguments

	Description
date_time	Az ISO 8601 formátumú YYYY-MM-DDThh:mm:ss.fffffffZegyezményes világidő (UTC) dátum- és idősztringje.
date_time_part	Az ISO 8601 dátumformátum-specifikációjának egy részét képviselő sztring. Ez a rész azt jelzi, hogy a dátum melyik eleme legyen a tároló.
bin_size	Nem kötelező numerikus érték, amely megadja a tároló méretét. Ha nincs megadva, az alapértelmezett érték a következő 1: .
bin_start_date_time	Opcionális UTC dátum- és idősztring ISO 8601 formátumban. Ha nincs megadva, az alapértelmezett érték a Unix-korszak 1970-01-01T00:00:00.000000Z.

Visszatérési típusok

Dátum- és idősztring-értéket ad vissza.

Példák

Ez a szakasz példákat tartalmaz a lekérdezési nyelv szerkezetének használatára.

Raktárhely dátum- és időértékei

Ebben a példában a DATETIMEBIN függvény egy dátumot és időpontot használ nap, óra, másodperc, valamint egyéni dobozméretekkel és kezdő dátumokkal.

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"
  }
]

Megjegyzések

• Ez a függvény a következő okokból tér vissza undefined :
• A megadott dátum- és időrész érvénytelen.
• A dobozméret értéke nem érvényes egész szám, nulla vagy negatív.
• A dátum és idő egyik argumentumban sem érvényes ISO 8601 dátum- és idősztring.
• A doboz kezdő dátuma és időpontja az "1601" évet, a Windows-korszakot megelőző év.
• Az ISO 8601 dátumformátum a függvényhez használandó érvényes dátum- és időrészeket adja meg: | | Formátum | | --- | --- | | Év | year, yyyy| yy | Hónap | month, mm| m | Nap | day, dd| d | Óra | hour, hh | | Perc | minute, mi| n | Második | second, ss| s | Ezredmásodperc | millisecond, ms | | Mikroszekundum | microsecond, mcs | | Nanosecond | nanosecond, ns |