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 1 standardvä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
,ss
s
| | Millisekunder |millisecond
|ms
| | Mikrosekunder |microsecond
|mcs
| | Nanosekunder |nanosecond
,ns
|