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

Fungsi mengembalikan DATETIMEBIN nilai string tanggal dan waktu yang merupakan hasil pengikatan (atau pembulatan) bagian dari string tanggal dan waktu yang disediakan.

Syntax

DATETIMEBIN(<date_time>, <date_time_part> [, <bin_size>] [, <bin_start_date_time>])

Arguments

	Description
date_time	String tanggal dan waktu Waktu Universal Terkoordinasi (UTC) dalam format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .
date_time_part	String yang mewakili bagian dari spesifikasi format tanggal ISO 8601. Bagian ini digunakan untuk menunjukkan aspek tanggal ke bin mana.
bin_size	Nilai numerik opsional yang menentukan ukuran bin. Jika tidak ditentukan, nilai defaultnya adalah 1.
bin_start_date_time	String tanggal dan waktu UTC opsional dalam format ISO 8601. Jika tidak ditentukan, nilai defaultnya adalah epoch 1970-01-01T00:00:00.000000ZUnix .

Tipe pengembalian

Mengembalikan nilai string tanggal dan waktu.

Examples

Bagian ini berisi contoh cara menggunakan konstruksi bahasa kueri ini.

Nilai tanggal dan waktu bin

Dalam contoh ini, DATETIMEBIN fungsi digunakan untuk mengikat tanggal dan waktu berdasarkan hari, jam, kedua, dan dengan ukuran bin kustom dan tanggal mulai.

SELECT VALUE {
  binDay: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd"),
  binHour: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh"),
  binSecond: DATETIMEBIN("2021-01-08T18:35:00.0000000", "ss"),
  binFiveHours: DATETIMEBIN("2021-01-08T18:35:00.0000000", "hh", 5),
  binSevenDaysUnixEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7),
  binSevenDaysWindowsEpoch: DATETIMEBIN("2021-01-08T18:35:00.0000000", "dd", 7, "1601-01-01T00:00:00.0000000")
}

[
  {
    "binDay": "2021-01-08T00:00:00.0000000Z",
    "binHour": "2021-01-08T18:00:00.0000000Z",
    "binSecond": "2021-01-08T18:35:00.0000000Z",
    "binFiveHours": "2021-01-08T15:00:00.0000000Z",
    "binSevenDaysUnixEpoch": "2021-01-07T00:00:00.0000000Z",
    "binSevenDaysWindowsEpoch": "2021-01-04T00:00:00.0000000Z"
  }
]

Komentar

• Fungsi ini kembali undefined karena alasan berikut:
• Bagian tanggal dan waktu yang ditentukan tidak valid.
• Nilai ukuran bin bukan bilangan bulat yang valid, nol, atau negatif.
• Tanggal dan waktu dalam salah satu argumen bukan string tanggal dan waktu ISO 8601 yang valid.
• Tanggal dan waktu untuk bin mulai mendahului tahun '1601'', epoch Windows.
• 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 |