Date & Time

DATETIME_TRUNC

BigQueryBigQuery

Memotong DATETIME ke granularitas yang ditentukan. Mendukung semua date parts dari MICROSECOND hingga YEAR.

Tipe hasil: DATETIMEDiperbarui: 16 Mei 2026

Syntax

SQL
DATETIME_TRUNC(datetime_expression, datetime_part)

Parameter

datetime_expressionDATETIMEwajib

DATETIME yang akan dipotong

datetime_partDATETIME_PARTwajib

Granularitas: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, etc.

Contoh Penggunaan

Basic Truncation

SQL
1SELECT
2 dt,
3 DATETIME_TRUNC(dt, HOUR) as hour,
4 DATETIME_TRUNC(dt, DAY) as day,
5 DATETIME_TRUNC(dt, MONTH) as month
6FROM UNNEST([DATETIME '2024-01-15 14:35:42']) as dt;

Potong datetime ke berbagai granularitas.

Hasil
dthourdaymonth
2024-01-15T14:35:422024-01-15T14:00:002024-01-15T00:00:002024-01-01T00:00:00

Hourly Aggregation

SQL
1SELECT
2 DATETIME_TRUNC(event_datetime, HOUR) as hour,
3 COUNT(*) as events,
4 SUM(revenue) as total_revenue
5FROM `project.dataset.sales`
6GROUP BY hour
7ORDER BY hour;

Agregasi penjualan per jam.

Pertanyaan Umum tentang DATETIME_TRUNC

Apa itu fungsi DATETIME_TRUNC di BigQuery?
Memotong DATETIME ke granularitas yang ditentukan. Mendukung semua date parts dari MICROSECOND hingga YEAR. Di BigQuery, fungsi DATETIME_TRUNC termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan DATETIME_TRUNC di BigQuery?
Gunakan sintaks berikut: DATETIME_TRUNC(datetime_expression, datetime_part). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi DATETIME_TRUNC?
Fungsi DATETIME_TRUNC mengembalikan nilai bertipe DATETIME. Pastikan tipe data hasil sudah sesuai dengan kebutuhan query atau formula kamu. Jika input mengandung nilai NULL, perilaku fungsi dapat berbeda — selalu periksa dokumentasi untuk memastikan hasilnya sesuai ekspektasi.
Apa saja parameter fungsi DATETIME_TRUNC?
Fungsi ini memiliki 2 parameter wajib. Parameter yang digunakan: datetime_expression (DATETIME, wajib): DATETIME yang akan dipotong; datetime_part (DATETIME_PART, wajib): Granularitas: YEAR, QUARTER, MONTH, WEEK, DAY, HOUR, MINUTE, SECOND, etc..