DATETIMEPART - Bahasa kueri di Cosmos DB (di Azure dan Fabric)

Fungsi mengembalikan DATETIMEPART nilai bagian tanggal dan waktu yang ditentukan untuk tanggal dan waktu yang disediakan.

Syntax

DATETIMEPART(<date_time_part>, <date_time>)

Arguments

	Description
date_time_part	String yang mewakili bagian dari spesifikasi format tanggal ISO 8601. Bagian ini digunakan untuk menunjukkan aspek tanggal mana yang akan diekstrak dan dikembalikan.
date_time	String tanggal dan waktu Waktu Universal Terkoordinasi (UTC) dalam format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Tipe pengembalian

Mengembalikan nilai numerik yang merupakan bilangan bulat positif.

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Mengekstrak bagian tanggal dan waktu

Dalam contoh ini, DATETIMEPART fungsi digunakan untuk mengekstrak tahun, bulan, hari, jam, menit, kedua, milidetik, mikrodetik, dan nanodetik dari tanggal.

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

Komentar

• Fungsi ini tidak menggunakan indeks.
• Format tanggal ISO 8601 menentukan bagian tanggal dan waktu yang valid untuk digunakan dengan fungsi ini: | | Format | | --- | --- | | Tahun | year, yyyy, yy | | Bulan | month, mm, m | | Hari | day, dd, d | | Jam | hour, hh | | Menit | minute, mi, n | | Kedua | second, ss, s | | Milidetik | millisecond, ms | | Microsecond | microsecond, mcs | | Nanodetik | nanosecond, ns |
• Fungsi ini kembali undefined karena alasan berikut:
  • Bagian tanggal dan waktu yang ditentukan tidak valid.
  • Tanggal dan waktu bukan string tanggal dan waktu ISO 8601 yang valid.