Dela via

DateTimeBin (NoSQL-fråga)

GÄLLER FÖR: NoSQL

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

Argument

beskrivning
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. Mer specifikt representerar det här delargumentet detaljnivån för binning (eller avrundning). Den minsta kornigheten för delen är dagar och den maximala kornigheten är nanosekunder.
bin_size (Valfritt) Ett valfritt numeriskt värde som anger storleken på lagerplatsen. Om det inte anges är 1standardvärdet .
bin_start_date_time (Valfritt) En valfri utc-datum- och tidssträng (Coordinated Universal Time) i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ. Det här argumentet för datum och tid anger startdatumet som ska hämtas från. Om det inte anges är standardvärdet Unix-epoken 1970-01-01T00:00:00.000000Z.

Kommentar

Mer information om FORMATET ISO 8601 finns i ISO 8601. Mer information om Unix-epoken finns i Unix-tid.

Returtyper

Returnerar en UTC-datum- och tidssträng i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Exempel

I följande exempel visas datumet 8 januari 2021 kl . 18:35 UTC med olika värden. Exemplet ändrar även lagerplatsstorleken och startdatum och tid för lagerplatsen.

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

Kommentarer

  • 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 lagerplatsstarten 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 | | --- | --- | | 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 |

Relaterat innehåll