Megosztás a következőn keresztül:

DateTimeBin (NoSQL-lekérdezés)

  • Cikk

A KÖVETKEZŐKRE VONATKOZIK: NoSQL

Egy dátum- és idősztring-értéket ad vissza, amely a megadott dátum- és idősztring egy részének dobozolása (vagy kerekítése) eredménye.

Szintaxis

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

Argumentumok

Description
date_time Egyezményes világidő (UTC) dátum- és idősztring ISO 8601 formátumban YYYY-MM-DDThh:mm:ss.fffffffZ.
date_time_part Az ISO 8601 dátumformátum-specifikáció egy részét képviselő sztring. Ez a rész azt jelzi, hogy a dátum melyik része legyen a raktáron. Ez a részargumentum a dobozolás (vagy kerekítés) részletességi szintjét jelöli. A rész minimális részletessége nap , a maximális részletesség pedig nanoszekron.
bin_size(Nem kötelező) Nem kötelező numerikus érték, amely a doboz méretét adja meg. Ha nincs megadva, az alapértelmezett érték a .1
bin_start_date_time(Nem kötelező) Opcionális egyezményes világidő (UTC) dátum- és idősztring ISO 8601 formátumban YYYY-MM-DDThh:mm:ss.fffffffZ. Ez a dátum- és időargumentum a kezdő dátumot adja meg a kezdő dátumtól a raktárhelyig. Ha nincs megadva, az alapértelmezett érték a Unix-alapidőszak 1970-01-01T00:00:00.000000Z.

Megjegyzés

További információ az ISO 8601 formátumról: ISO 8601. A Unix-korszakról további információt a Unix-idő című témakörben talál.

Visszatérési típusok

EGY UTC dátum- és idősztringet ad vissza ISO 8601 formátumban YYYY-MM-DDThh:mm:ss.fffffffZ.

Példák

Az alábbi példa a 2021. január 8.,18:35 (UTC ) dátumot különböző értékek szerint tartalmazza. A példa a doboz méretét, valamint a kezdő dátumot és időpontot is módosítja.

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 ad undefined vissza:
    • 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 az idő egyik argumentumban sem érvényes ISO 8601 dátum- és idősztring.
    • A intervallum kezdő dátuma és időpontja az év 1601előtti, a Windows-alapidőszakot.
  • Az ISO 8601 dátumformátum a függvényhez használandó érvényes dátum- és időrészeket adja meg: | | Formátum | | --- | --- | | Nap | day, dd| d | Óra | hour, hh | | Perc | minute, mi| n | Második | second, ss, s | | Ezredmásodperc | millisecond, ms | | Mikroszekron, | microsecondmcs | | Nanosecond | nanosecond,ns |

Kapcsolódó tartalom