DATETIMEPART - Cosmos DB'de sorgu dili (Azure ve Doku'da)

İşlev, DATETIMEPART sağlanan tarih ve saat için belirtilen tarih ve saat bölümünün değerini döndürür.

Sözdizimi

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
date_time_part	ISO 8601 tarih biçimi belirtiminin bir bölümünü temsil eden dize. Bu bölüm, tarihin hangi yönünün ayıklanıp döndürüleceği belirtmek için kullanılır.
date_time	ISO 8601 biçiminde YYYY-MM-DDThh:mm:ss.fffffffZeşgüdümlü Evrensel Saat (UTC) tarih ve saat dizesi.

Dönüş türleri

Pozitif tamsayı olan sayısal bir değer döndürür.

Örnekler

Bu bölüm, bu sorgu dili yapısının nasıl kullanılacağına örnekler içerir.

Tarih ve saat parçalarını ayıklama

Bu örnekte işlev, DATETIMEPART bir tarihten yıl, ay, gün, saat, dakika, saniye, milisaniye, mikrosaniye ve nanosaniye ayıklamak için kullanılır.

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

Açıklamalar

• Bu işlev dizini kullanmaz.
• ISO 8601 tarih biçimi, bu işlevle kullanılacak geçerli tarih ve saat bölümlerini belirtir: | | Biçim | | --- | --- | | Yıl | year, yyyy, yy | | Ay | month, mm, m | | Gün | day, dd, d | | Saat | hour, hh | | Minute | minute, mi, n | | İkinci | second, ss, s | | Milisaniye | millisecond, ms | | Mikrosaniye | microsecond, mcs | | Nanosaniye | nanosecond,ns |
• Bu işlev şu nedenlerle döndürülüyor undefined :
  • Belirtilen tarih ve saat bölümü geçersiz.
  • Tarih ve saat geçerli bir ISO 8601 tarih ve saat dizesi değildir.