Auf Englisch lesen

Teilen über


DateTimePart (NoSQL-Abfrage)

GILT FÜR: NoSQL

Gibt den Wert des angegebenen Datums- und Uhrzeitteils für das angegebene Datum und die angegebene Uhrzeit zurück.

Syntax

DateTimePart(<date_time_part> , <date_time>)

Argumente

BESCHREIBUNG
date_time Eine Datums- und Uhrzeitzeichenfolge in UTC (Coordinated Universal Time, koordinierte Weltzeit) im ISO 8601-Format YYYY-MM-DDThh:mm:ss.fffffffZ.
date_time_part Eine Zeichenfolge, die einen Teil einer Datumsformatspezifikation im ISO 8601-Format darstellt. Mit diesem Teil wird angegeben, welcher Aspekt des Datums extrahiert und zurückgegeben werden soll.

Hinweis

Weitere Informationen zum ISO 8601-Format finden Sie unter ISO 8601.

Rückgabetypen

Gibt einen numerischen Wert zurück, der eine positive ganze Zahl ist.

Beispiele

Im folgenden Beispiel werden verschiedene Teile des Datums und der Uhrzeit für 29. Mai 2016 08:30 UTC zurückgegeben.

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

Hinweise

  • Diese Funktion gibt aus folgenden Gründen zurück undefined :
    • Der angegebene Teil von Datum und Uhrzeit ist ungültig.
    • Datum und Uhrzeit sind keine gültigen Datums- und Uhrzeitzeichenfolgen im ISO 8601-Format.
  • Das ISO 8601-Datumsformat gibt gültige Datums- und Uhrzeitteile an, die mit dieser Funktion verwendet werden sollen: | | Format | | --- | --- | | Jahr | year, yyyy, yy | | Monat | month, mm, m | | Tag | day, dd, d | | Stunde | hour, hh | | Minute | minute, mi, n | | Sekunde | second, ss, s | | Millisekunde | millisecond, ms | | Mikrosekunde | microsecond, mcs | | Nanosekunde | nanosecond, ns |
  • Diese Funktion verwendet den Index nicht.