DATETIMEPART – Frågespråk i Cosmos DB (i Azure och Fabric)

Funktionen DATETIMEPART returnerar värdet för den angivna datum- och tidsdelen för angivet datum och tid.

Syntax

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
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.
date_time	En utc-datum- och tidssträng (Coordinated Universal Time) i FORMATET ISO 8601 YYYY-MM-DDThh:mm:ss.fffffffZ.

Returtyper

Returnerar ett numeriskt värde som är ett positivt heltal.

Examples

Det här avsnittet innehåller exempel på hur du använder den här frågespråkkonstruktionen.

Extrahera datum- och tidsdelar

I det här exemplet DATETIMEPART används funktionen för att extrahera år, månad, dag, timme, minut, sekund, millisekunder, mikrosekunder och nanosekunder från ett datum.

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
  }
]

Anmärkningar

• Den här funktionen använder inte indexet.
• 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 , sss | | Millisekunder | millisecond| ms | | Mikrosekunder | microsecond| mcs | | Nanosekunder | nanosecond,ns |
• 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 .