DateTimePart (zapytanie NoSQL)
DOTYCZY: NoSQL
Zwraca wartość określonej części daty i godziny dla podanej daty i godziny.
Składnia
DateTimePart(<date_time_part> , <date_time>)
Argumenty
opis | |
---|---|
date_time |
Ciąg daty i godziny koordynowanego czasu uniwersalnego (UTC) w formacie YYYY-MM-DDThh:mm:ss.fffffffZ ISO 8601. |
date_time_part |
Ciąg reprezentujący część specyfikacji formatu daty ISO 8601. Ta część służy do wskazywania, który aspekt daty ma być wyodrębniony i zwracany. |
Uwaga
Aby uzyskać więcej informacji na temat formatu ISO 8601, zobacz ISO 8601.
Typy zwracane
Zwraca wartość liczbową, która jest dodatnią liczbą całkowitą.
Przykłady
Poniższy przykład zwraca różne części daty i godziny 29 maja 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
}
]
Uwagi
- Ta funkcja zwraca
undefined
następujące przyczyny:- Określona część daty i godziny jest nieprawidłowa.
- Data i godzina nie są prawidłowym ciągiem daty i godziny ISO 8601.
- Format daty ISO 8601 określa prawidłowe części daty i godziny do użycia z tą funkcją: | | Format | | --- | --- | | Rok |
year
,yyyy
,yy
| | Miesiąc |month
,mm
,m
| | Dzień |day
,dd
,d
| | Godzina |hour
,hh
| | Minuta |minute
,mi
,n
| | Drugi |second
,ss
,s
| | Milisekundy |millisecond
,ms
| | Mikrosekundy |microsecond
,mcs
| | Nanosekundy |nanosecond
,ns
| - Ta funkcja nie używa indeksu.