DATETIMEPART – Dotazovací jazyk ve službě Cosmos DB (v Azure a prostředcích infrastruktury)

Funkce DATETIMEPART vrátí hodnotu zadané části data a času pro zadané datum a čas.

Syntaxe

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
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.
date_time	Řetězec data a času koordinovaného univerzálního času (UTC) ve formátu YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Návratové typy

Vrátí číselnou hodnotu, která je kladné celé číslo.

Examples

Tato část obsahuje příklady použití tohoto konstruktoru dotazovacího jazyka.

Extrahování částí data a času

V tomto příkladu se DATETIMEPART funkce používá k extrakci roku, měsíce, dne, hodiny, minuty, sekundy, milisekundy, mikrosekundy a nanosekundy od data.

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 nevyužívá index.
• Formát data ISO 8601 určuje platné části data a času, které se mají použít s touto funkcí: | | Formát | | --- | --- | | Rok | year, | yyyyyy| Month | month, , mmm| | Den | day, | ddd| Hodina | hour, hh | | Minuta | minute, | min | Sekunda | second, | sss | Milisekundy | millisecond, ms | | Mikrosekundy | microsecond, mcs | | Nanosekundová | nanosecondns |
• 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 .