DateTimePart (NoSQL-fråga)
GÄLLER FÖR: NoSQL
Returnerar värdet för den angivna datum- och tidsdelen för angivet datum och tid.
Syntax
DateTimePart(<date_time_part> , <date_time>)
Argument
beskrivning | |
---|---|
date_time |
En utc-datum- och tidssträng (Coordinated Universal Time) i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ . |
date_time_part |
En sträng som representerar en del av en ISO 8601-datumformatspecifikation. Den här delen används för att ange vilken aspekt av datumet som ska extraheras och returneras. |
Kommentar
Mer information om FORMATET ISO 8601 finns i ISO 8601.
Returtyper
Returnerar ett numeriskt värde som är ett positivt heltal.
Exempel
I följande exempel returneras olika delar av datum och tid 29 maj 2016 08:30 UTC.
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
}
]
Kommentarer
- Den här funktionen returnerar
undefined
av följande skäl:- Den angivna datum- och tidsdelen är ogiltig.
- Datum och tid är inte en giltig DATUM- och tidssträng för ISO 8601.
- Datumformatet ISO 8601 anger giltiga datum- och tidsdelar som ska användas med den här funktionen: | | Format | | --- | --- | | År |
year
,yyyy
,yy
| | Månad |month
,mm
,m
| | Dag |day
,dd
,d
| | Timme |hour
,hh
| | Minut |minute
,mi
,n
| | För det andra |second
,ss
s
| | Millisekunder |millisecond
|ms
| | Mikrosekunder |microsecond
|mcs
| | Nanosekunder |nanosecond
,ns
| - Den här funktionen använder inte indexet.