DateTimePart (dotaz NoSQL)
PLATÍ PRO: NoSQL
Vrátí hodnotu zadané části data a času pro zadané datum a čas.
Syntaxe
DateTimePart(<date_time_part> , <date_time>)
Argumenty
Popis | |
---|---|
date_time |
Řetězec data a času koordinovaného univerzálního času (UTC) ve formátu YYYY-MM-DDThh:mm:ss.fffffffZ ISO 8601 . |
date_time_part |
Řetězec představující část specifikace formátu data ISO 8601. Tato část se používá k označení, který aspekt data se má extrahovat a vrátit. |
Poznámka:
Další informace o formátu ISO 8601 naleznete v tématu ISO 8601.
Návratové typy
Vrátí číselnou hodnotu, která je kladné celé číslo.
Příklady
Následující příklad vrátí různé části data a času 29. května 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
}
]
Poznámky
- Tato funkce se vrátí
undefined
z těchto důvodů:- Zadaná část data a času je neplatná.
- Datum a čas nejsou platným řetězcem data a času ISO 8601.
- Formát data ISO 8601 určuje platné části data a času, které se mají použít s touto funkcí: | | Formát | | --- | --- | | Rok |
year
, |yy
yyyy
| Month |month
, ,m
mm
| | Den |day
, |d
|dd
Hodina |hour
,hh
| | Minuta |minute
, | |mi
n
Sekunda |second
, | |ss
s
Milisekundy |millisecond
,ms
| | Mikrosekundy |microsecond
,mcs
| | Nanosekundová |nanosecond
ns
| - Tato funkce nepoužívá index.