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

DateTimeBin (NoSQL-lekérdezés)

  • Cikk

A KÖVETKEZŐRE VONATKOZIK: NoSQL

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

Syntax

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

Argumentumok

Leírás
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ó. 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 nanoszekundum.
bin_size(Nem kötelező) 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(Nem kötelező) Az ISO 8601 formátumú YYYY-MM-DDThh:mm:ss.fffffffZ, nem kötelező egyezményes világidő (UTC) dátum- és idősztring. Ez a dátum- és időargumentum a kezdő dátumot adja meg. Ha nincs megadva, az alapértelmezett érték a Unix-korszak 1970-01-01T00:00:00.000000Z.

Feljegyzés

További információ az ISO 8601 formátumról: ISO 8601. További információ a Unix-korszakról: Unix time.

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-i dátumot 18:35 -kor (UTC) különböző értékek szerint tartalmazza. A példa a raktárhely méretét, valamint a raktárhely kezdő dátumát és időpontját 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 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 kuka kezdő dátuma és időpontja az évet 1601, a Windows-korszakot megelőzi.
  • 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 | | Mikroszekundum | microsecond, mcs | | Nanosecond | nanosecond, ns |

Kapcsolódó tartalom