Sdílet prostřednictvím


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.fffffffZISO 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 | ddHodina | hour, hh | | Minuta | minute, | | minSekunda | second, | | sssMilisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundová | nanosecondns |
  • Tato funkce nepoužívá index.