Delen via

DateTimePart (NoSQL-query)

  • Artikel

VAN TOEPASSING OP: NoSQL

Retourneert de waarde van het opgegeven datum- en tijdgedeelte voor de opgegeven datum en tijd.

Syntaxis

DateTimePart(<date_time_part> , <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 onderdeel wordt gebruikt om aan te geven welk aspect van de datum moet worden geëxtraheerd en geretourneerd.

Notitie

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

Retourtypen

Retourneert een numerieke waarde die een positief geheel getal is.

Voorbeelden

In het volgende voorbeeld worden verschillende onderdelen van de datum en tijd van 29 mei 2016 08:30 UTC geretourneerd.

SELECT VALUE {
    getYear: DateTimePart("yyyy", "2016-05-29T08:30:00.1301617"),
    getMonth: DateTimePart("mm", "2016-05-29T08:30:00.1301617"),
    getDay: DateTimePart("dd", "2016-05-29T08:30:00.1301617"),
    getHour: DateTimePart("hh", "2016-05-29T08:30:00.1301617"),
    getMinute: DateTimePart("mi", "2016-05-29T08:30:00.1301617"),
    getSecond: DateTimePart("ss", "2016-05-29T08:30:00.1301617"),
    getMillisecond: DateTimePart("ms", "2016-05-29T08:30:00.1301617"),
    getMicrosecond: DateTimePart("mcs", "2016-05-29T08:30:00.1301617"),
    getNanosecond: DateTimePart("ns", "2016-05-29T08:30:00.1301617")
}

[
  {
    "getYear": 2016,
    "getMonth": 5,
    "getDay": 29,
    "getHour": 8,
    "getMinute": 30,
    "getSecond": 0,
    "getMillisecond": 130,
    "getMicrosecond": 130161,
    "getNanosecond": 130161700
  }
]

Opmerkingen

  • Deze functie retourneert undefined om deze redenen:
    • Het opgegeven datum- en tijdgedeelte is ongeldig.
    • De datum en tijd zijn geen geldige ISO 8601-datum- en tijdtekenreeks.
  • De ISO 8601-datumnotatie geeft geldige datum- en tijdonderdelen op die moeten worden gebruikt met deze functie: | | Opmaak | | --- | --- | | Jaar | year, yyyyyy | | Maand | month, mmm | | Dag | day, ddd | | Uur | hour, hh | | Minuut | minute, min | | Tweede | second, sss | | Milliseconden | millisecond, ms | Microseconde | microsecond, mcs | | Nanoseconden | nanosecond,ns |
  • Deze functie gebruikt de index niet.

Gerelateerde inhoud