Sdílet prostřednictvím

DateTimeBin (dotaz NoSQL)

  • Článek

PLATÍ PRO: NoSQL

Vrátí hodnotu řetězce data a času, která je výsledkem binningu (nebo zaokrouhlování) části zadaného řetězce data a času.

Syntaxe

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

Argumenty

Popis
date_time Řetězec data a času koordinovaného univerzálního času (UTC) ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
date_time_part Řetězec představující část specifikace formátu data ISO 8601. Tato část slouží k označení toho, který aspekt data se má přihrádka shodovat. Konkrétně tento argument části představuje úroveň členitosti binningu (nebo zaokrouhlování). Minimální členitost části je dny a maximální členitost je nanosekund.
bin_size(Volitelné) Volitelná číselná hodnota určující velikost intervalu. Pokud není zadána, je výchozí hodnota 1.
bin_start_date_time(Volitelné) Volitelný řetězec data a času UTC (Coordinated Universal Time) ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 . Tento argument data a času určuje počáteční datum pro interval. Pokud není zadána, výchozí hodnota je Unix epocha 1970-01-01T00:00:00.000000Z.

Poznámka:

Další informace o formátu ISO 8601 naleznete v tématu ISO 8601. Další informace o unixové epochě naleznete v tématu Unix time.

Návratové typy

Vrátí řetězec data a času UTC ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Příklady

Následující příklad přihrádá datum 8. ledna 2021 v 18:35 UTC podle různých hodnot. Příklad také změní velikost přihrádky a počáteční datum a čas přihrádky.

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

Poznámky

  • Tato funkce se vrátí undefined z těchto důvodů:
    • Zadaná část data a času je neplatná.
    • Hodnota velikosti přihrádky není platné celé číslo, je nula nebo je záporná.
    • Datum a čas v obou argumentech není platným řetězcem data a času ISO 8601.
    • Datum a čas začátku intervalu předchází roku 1601, epocha Windows.
  • Formát data ISO 8601 určuje platné části data a času, které se mají použít s touto funkcí: | | Formát | | --- | --- | | Den | day, | d dd| Hodina | hour, hh | | Minuta | minute, | | minSekunda | second, | | sssMilisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundová | nanosecondns |

Související obsah