fungsi time_bucket

Berlaku untuk:tanda centang ya Databricks SQL ditandai ya Databricks Runtime 19 ke atas

Mengembalikan awal bucket waktu lebar tetap tempat timestamp masuk, diselaraskan dengan asal.

Sintaks

time_bucket(bucketSize, ts [, origin])

Argumen

  • bucketSize: Ekspresi INTERVAL konstan yang menentukan ukuran setiap bucket. Mendukung interval siang hari dan tahun-bulan. Harus positif dan tidak nol.
  • ts: Ekspresi A TIMESTAMP or TIMESTAMP_NTZ ke bucket.
  • origin: Ekspresi opsional TIMESTAMP atau TIMESTAMP_NTZ konstan yang mendefinisikan jangkar penyelarasan grid bucket. Secara default menjadi 1970-01-01 00:00:00. Harus tipe yang sama dengan ts.

Returns

Nilai dengan tipe yang sama dengan ts (TIMESTAMP atau TIMESTAMP_NTZ). Nilai adalah awal dari bucket [start, start + bucketSize) setengah terbuka yang berisi ts. Awal selalu kurang dari atau sama dengan ts, dan batas bucket berikutnya (start + bucketSize) secara ketat lebih besar dari ts.

Catatan

  • time_bucket membagi sumbu waktu menjadi interval berurutan yang tidak tumpang tindih dengan ukuran bucketSize, yang berakar pada origin. Ia mengembalikan awal interval yang mengandung ts.
  • origin tidak perlu mendahului ts. Itu hanya mendefinisikan penyelarasan grid bucket. Kisi ini membentang tak hingga di kedua arah dari origin.
  • Untuk TIMESTAMP_NTZ, time_bucket bucket di UTC. Untuk TIMESTAMP, bucket interval tahun-bulan dan komponen kalender-hari dari bucket interval siang-waktu selaras dengan zona waktu sesi.
  • Jika ada argumen yang , NULLhasilnya adalah NULL.
  • Gunakan date_trunc untuk batas yang selaras dengan kalender seperti pengelompokan berdasarkan bulan kalender. Gunakan time_bucket ketika lebar atau penyelarasan bucket ditentukan oleh pengguna.

Kondisi kesalahan umum

Contoh

-- 15-minute buckets (default origin at epoch)
> SELECT time_bucket(INTERVAL '15' MINUTE, TIMESTAMP '2024-01-01 11:27:00');
 2024-01-01 11:15:00

-- 1-hour buckets
> SELECT time_bucket(INTERVAL '1' HOUR, TIMESTAMP '2024-01-01 11:27:00');
 2024-01-01 11:00:00

-- Custom origin shifts bucket alignment to :05 past the hour
> SELECT time_bucket(INTERVAL '1' HOUR, TIMESTAMP '2024-01-01 11:27:00', TIMESTAMP '1970-01-01 00:05:00');
 2024-01-01 11:05:00

-- TIMESTAMP_NTZ variant
> SELECT time_bucket(INTERVAL '15' MINUTE, TIMESTAMP_NTZ '2024-01-01 11:27:00');
 2024-01-01 11:15:00

-- ts exactly on a bucket boundary returns itself
> SELECT time_bucket(INTERVAL '15' MINUTE, TIMESTAMP '2024-01-01 11:15:00');
 2024-01-01 11:15:00

-- Origin after ts: grid extends backward
> SELECT time_bucket(INTERVAL '1' HOUR, TIMESTAMP '2024-01-01 11:27:00', TIMESTAMP '2025-01-01 00:30:00');
 2024-01-01 10:30:00

-- Monthly buckets (default epoch origin: 1st of month)
> SELECT time_bucket(INTERVAL '1' MONTH, TIMESTAMP '2024-03-15 11:27:00');
 2024-03-01 00:00:00

-- Quarterly buckets
> SELECT time_bucket(INTERVAL '3' MONTH, TIMESTAMP '2024-05-15 10:00:00');
 2024-04-01 00:00:00

-- Monthly buckets with origin on the 15th
> SELECT time_bucket(INTERVAL '1' MONTH, TIMESTAMP '2024-03-20 09:00:00', TIMESTAMP '1970-01-15 00:00:00');
 2024-03-15 00:00:00

-- Origin on 31st: day clamping in short months
> SELECT time_bucket(INTERVAL '1' MONTH, TIMESTAMP '2024-03-01 12:00:00', TIMESTAMP '1970-01-31 00:00:00');
 2024-02-29 00:00:00

-- Zero bucket width is rejected
> SELECT time_bucket(INTERVAL '0' SECOND, TIMESTAMP '2024-01-01 11:00:00');
 [DATATYPE_MISMATCH.VALUE_OUT_OF_RANGE] The bucketSize must be between (0, inf) (current value = INTERVAL '00' SECOND).
  • Last updated on