Share via


DateTimeDiff (NoSQL-query)

VAN TOEPASSING OP: NoSQL

Retourneert het verschil, als een geheel getal met teken, van het opgegeven datum- en tijdgedeelte tussen twee datum- en tijdwaarden.

Syntaxis

DateTimeDiff(<date_time_part>, <start_date_time>, <end_date_time>)

Argumenten

Description
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 moet worden vergeleken.
start_date_time Een UTC-tekenreeks (Coordinated Universal Time) in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.
end_date_time Een UTC-tekenreeks (Coordinated Universal Time) in de ISO 8601-indeling YYYY-MM-DDThh:mm:ss.fffffffZ.

Notitie

Zie ISO 8601 voor meer informatie over de ISO 8601-indeling.

Retourtypen

Retourneert een numerieke waarde die een geheel getal met teken is.

Voorbeelden

In de volgende voorbeelden worden 4 februari 2019 16:00 UTC en 5 maart 2018 05:00 UTC vergeleken met behulp van verschillende datum- en tijdonderdelen.

SELECT VALUE {
    diffPastYears: DateTimeDiff("yyyy", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastMonths: DateTimeDiff("mm", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastDays: DateTimeDiff("diffDays", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastHours: DateTimeDiff("hh", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffPastSeconds: DateTimeDiff("ss", "2019-02-04T16:00:00.0000000", "2018-03-05T05:00:00.0000000"),
    diffFutureYears: DateTimeDiff("yyyy", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureMonths: DateTimeDiff("mm", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureDays: DateTimeDiff("diffDays", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureHours: DateTimeDiff("hh", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000"),
    diffFutureSeconds: DateTimeDiff("ss", "2018-03-05T05:00:00.0000000", "2019-02-04T16:00:00.0000000")
}
[
  {
    "diffPastYears": -1,
    "diffPastMonths": -11,
    "diffPastHours": -8075,
    "diffPastSeconds": -29070000,
    "diffFutureYears": 1,
    "diffFutureMonths": 11,
    "diffFutureHours": 8075,
    "diffFutureSeconds": 29070000
  }
]

Opmerkingen

  • Deze functie retourneert undefined om de volgende redenen:
    • Het opgegeven datum- en tijdgedeelte is ongeldig.
    • De datum en tijd in het argument begin of einde zijn geen geldige ISO 8601-datum- en tijdreeks.
  • De ISO 8601-datumnotatie bevat geldige datum- en tijdonderdelen die moeten worden gebruikt met deze functie: | | Opmaak | | --- | --- | | Dag | day, dd| d | Uur | hour | hh | Minuut | minute, mi| n | Second | second, ss, s | | Milliseconde | millisecond, ms | | Microseconde | microsecond, mcs | | Nanoseconde | nanosecond, ns |
  • De functie retourneert altijd een tekenwaarde voor een geheel getal. De functie retourneert een meting van het aantal grenzen dat is overschreden voor het opgegeven datum- en tijdgedeelte, niet een meting van het tijdsinterval.