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.
DateTimePart(<date_time_part> , <date_time>)
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.
Gibt einen numerischen Wert zurück, der eine positive ganze Zahl ist.
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
}
]
- 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.