DATETIMEBIN – Dotazovací jazyk ve službě Cosmos DB (v Azure a prostředcích infrastruktury)

Funkce DATETIMEBIN 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>])

Arguments

	Description
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.
bin_size	Volitelná číselná hodnota určující velikost intervalu. Pokud není zadána, je výchozí hodnota 1.
bin_start_date_time	Volitelný řetězec data a času UTC ve formátu ISO 8601. Pokud není zadána, výchozí hodnota je Unix epocha 1970-01-01T00:00:00.000000Z.

Návratové typy

Vrátí hodnotu řetězce data a času.

Examples

Tato část obsahuje příklady použití tohoto konstruktoru dotazovacího jazyka.

Hodnoty data a času přihrádky

V tomto příkladu se DATETIMEBIN funkce používá k přihrádky data a času podle dne, hodiny, sekundy a s vlastními velikostmi přihrádek a počátečními daty.

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, epochy Windows.
• Formát data ISO 8601 určuje platné části data a času, které se mají použít s touto funkcí: | | Formát | | --- | --- | | Rok | year, | yyyyyy| Month | month, , mmm| | Den | day, | ddd| Hodina | hour, hh | | Minuta | minute, | min | Sekunda | second, | sss | Milisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundová | nanosecondns |