DATETIMEPART - Lekérdezési nyelv a Cosmos DB-ben (az Azure-ban és a Fabricben)

A DATETIMEPART függvény a megadott dátum- és időrész értékét adja vissza.

Szemantika

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
date_time_part	Az ISO 8601 dátumformátum-specifikációjának egy részét képviselő sztring. Ez a rész azt jelzi, hogy a dátum melyik aspektusát kell kinyerni és visszaadni.
date_time	Az ISO 8601 formátumú YYYY-MM-DDThh:mm:ss.fffffffZegyezményes világidő (UTC) dátum- és idősztringje.

Visszatérési típusok

Pozitív egész számértéket ad vissza.

Példák

Ez a szakasz példákat tartalmaz a lekérdezési nyelv szerkezetének használatára.

Dátum- és időrészek kinyerés

Ebben a példában a függvény az DATETIMEPART év, hónap, nap, óra, perc, másodperc, ezredmásodperc, mikroszekundum és nanoszekundum kinyerésére szolgál egy dátumból.

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

Megjegyzések

• Ez a függvény nem használja az indexet.
• Az ISO 8601 dátumformátum a függvényhez használandó érvényes dátum- és időrészeket adja meg: | | Formátum | | --- | --- | | Év | year, yyyy| yy | Hónap | month, mm| m | Nap | day, dd| d | Óra | hour, hh | | Perc | minute, mi| n | Második | second, ss| s | Ezredmásodperc | millisecond, ms | | Mikroszekundum | microsecond, mcs | | Nanosecond | nanosecond, ns |
• Ez a függvény a következő okokból tér vissza undefined :
  • A megadott dátum- és időrész érvénytelen.
  • A dátum és az idő nem érvényes ISO 8601 dátum- és idősztring.