Delen via

DateTimeBin (NoSQL-query)

  • Artikel

VAN TOEPASSING OP: NoSQL

Retourneert een datum- en tijdtekenreekswaarde die het resultaat is van binning (of afronding) van een deel van de opgegeven datum- en tijdtekenreeks.

Syntaxis

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

Argumenten

Beschrijving
date_time Een UTC-datum- en tijdtekenreeks (Coordinated Universal Time) in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.
date_time_part Een tekenreeks die een deel van een ISO 8601-datumnotatiespecificatie vertegenwoordigt. Dit deel wordt gebruikt om aan te geven welk aspect van de datum-naar-bin moet worden aangegeven. Dit onderdeelargument vertegenwoordigt met name het granulariteitsniveau voor binning (of afronding). De minimale granulariteit voor het onderdeel is dagen en de maximale granulariteit is nanoseconden.
bin_size(Optioneel) Een optionele numerieke waarde die de grootte van de bin aangeeft. Als dit niet is opgegeven, is 1de standaardwaarde .
bin_start_date_time(Optioneel) Een optionele UTC-datum- en tijdtekenreeks (Coordinated Universal Time) in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ. Met dit datum- en tijdargument wordt de begindatum opgegeven van waaruit de bin moet worden opgehaald. Als dit niet is opgegeven, is de standaardwaarde het Unix-epoch 1970-01-01T00:00:00.000000Z.

Notitie

Zie ISO 8601 voor meer informatie over de ISO 8601-indeling. Zie Unix-tijd voor meer informatie over het Unix-tijdperk.

Retourtypen

Retourneert een UTC-datum- en tijdtekenreeks in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.

Voorbeelden

In het volgende voorbeeld wordt de datum 8 januari 2021 om 18:35 UTC op verschillende waarden geplaatst. In het voorbeeld wordt ook de grootte van de bin gewijzigd en de begindatum en -tijd van de bin.

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

Opmerkingen

  • Deze functie retourneert undefined om deze redenen:
    • Het opgegeven datum- en tijdgedeelte is ongeldig.
    • De waarde van de bin-grootte is geen geldig geheel getal, nul of negatief.
    • De datum en tijd in beide argumenten zijn geen geldige ISO 8601-datum- en tijdtekenreeks.
    • De datum en tijd voor het begin van de bin gaan vooraf aan het jaar 1601, het Windows-epoch.
  • De ISO 8601-datumnotatie geeft geldige datum- en tijdonderdelen op die moeten worden gebruikt met deze functie: | | Opmaak | | --- | --- | | Dag | day, ddd | | Uur | hour, hh | | Minuut | minute, min | | Tweede | second, sss | | Milliseconden | millisecond, ms | Microseconde | microsecond, mcs | | Nanoseconden | nanosecond,ns |

Gerelateerde inhoud