DATETIMEBIN – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen DATETIMEBIN returnerar ett datum- och tidssträngsvärde som är resultatet av binning (eller avrundning) en del av den angivna datum- och tidssträngen.

Syntax

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

Arguments

	Description
date_time	En utc-datum- och tidssträng (Coordinated Universal Time) i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.
date_time_part	En sträng som representerar en del av en ISO 8601-datumformatspecifikation. Den här delen används för att ange vilken aspekt av datumet som ska lagras.
bin_size	Ett valfritt numeriskt värde som anger storleken på lagerplatsen. Om det inte anges är 1standardvärdet .
bin_start_date_time	En valfri UTC-datum- och tidssträng i FORMATET ISO 8601. Om det inte anges är standardvärdet Unix-epoken 1970-01-01T00:00:00.000000Z.

Returtyper

Returnerar ett datum- och tidssträngsvärde.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Datum- och tidsvärden för lagerplats

I det här exemplet DATETIMEBIN används funktionen för att gruppera ett datum och en tid efter dag, timme, sekund och med anpassade lagerplatsstorlekar och startdatum.

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

Anmärkningar

• Den här funktionen returnerar undefined av följande skäl:
• Den angivna datum- och tidsdelen är ogiltig.
• Värdet för bin-storlek är inte ett giltigt heltal, är noll eller negativt.
• Datum och tid i något av argumenten är inte en giltig DATUM- och tidssträng för ISO 8601 .
• Datum och tid för bin-start föregår året "1601", Windows-epoken.
• Datumformatet ISO 8601 anger giltiga datum- och tidsdelar som ska användas med den här funktionen: | | Format | | --- | --- | | År | year, yyyy, yy | | Månad | month, mm, m | | Dag | day, dd, d | | Timme | hour, hh | | Minut | minute, mi, n | | För det andra | second , sss | | Millisekunder | millisecond| ms | | Mikrosekunder | microsecond| mcs | | Nanosekunder | nanosecond,ns |