Bagikan melalui

DateTimeBin (kueri NoSQL)

  • Artikel

BERLAKU UNTUK: NoSQL

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

Sintaks

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

Argumen

Deskripsi
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. Secara khusus, argumen bagian ini mewakili tingkat granularitas untuk binning (atau pembulatan). Granularitas minimum untuk bagian adalah hari dan granularitas maksimum adalah nanodetik.
bin_size(Opsional) Nilai numerik opsional yang menentukan ukuran bin. Jika tidak ditentukan, nilai defaultnya adalah 1.
bin_start_date_time(Opsional) String tanggal dan waktu Waktu Universal Terkoordinasi (UTC) opsional dalam format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 . Argumen tanggal dan waktu ini menentukan tanggal mulai ke bin dari. Jika tidak ditentukan, nilai defaultnya adalah epoch 1970-01-01T00:00:00.000000ZUnix .

Catatan

Untuk informasi selengkapnya tentang format ISO 8601, lihat ISO 8601. Untuk informasi selengkapnya tentang epoch Unix, lihat Waktu Unix.

Jenis yang dikembalikan

Mengembalikan string tanggal dan waktu UTC dalam format YYYY-MM-DDThh:mm:ss.fffffffZISO 8601 .

Contoh

Contoh berikut mengikat tanggal 8 Januari 2021 pukul 18.35 UTC dengan berbagai nilai. Contohnya juga mengubah ukuran bin, dan tanggal dan waktu mulai bin.

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

Keterangan

  • 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 | | --- | --- | | Hari | day, dd, d | | Jam | hour, hh | | Menit | minute, mi, n | | Kedua | second, ss, s | | Milidetik | millisecond, ms | | Microsecond | microsecond, mcs | | Nanodetik | nanosecond, ns |

Konten terkait