Date & Time

DATETIME_DIFF

BigQueryBigQuery

Menghitung selisih antara dua DATETIME dalam unit yang ditentukan.

Tipe hasil: INT64Diperbarui: 16 Mei 2026

Syntax

SQL
DATETIME_DIFF(datetime_expression_a, datetime_expression_b, datetime_part)

Parameter

datetime_expression_aDATETIMEwajib

DATETIME akhir (minuend)

datetime_expression_bDATETIMEwajib

DATETIME awal (subtrahend)

datetime_partDATETIME_PARTwajib

Unit hasil: YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, etc.

Contoh Penggunaan

Calculate Duration

SQL
1SELECT
2  start_datetime,
3  end_datetime,
4  DATETIME_DIFF(end_datetime, start_datetime, HOUR) as hours,
5  DATETIME_DIFF(end_datetime, start_datetime, MINUTE) as minutes
6FROM `project.dataset.sessions`;

Hitung durasi session.

Time Since Event

SQL
1SELECT
2  event_id,
3  event_datetime,
4  DATETIME_DIFF(CURRENT_DATETIME(), event_datetime, DAY) as days_ago
5FROM `project.dataset.events`
6ORDER BY days_ago;

Hitung berapa hari yang lalu event terjadi.

Pertanyaan Umum tentang DATETIME_DIFF

Apa itu fungsi DATETIME_DIFF di BigQuery?
Menghitung selisih antara dua DATETIME dalam unit yang ditentukan. Di BigQuery, fungsi DATETIME_DIFF termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan DATETIME_DIFF di BigQuery?
Gunakan sintaks berikut: DATETIME_DIFF(datetime_expression_a, datetime_expression_b, datetime_part). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi DATETIME_DIFF?
Fungsi DATETIME_DIFF mengembalikan nilai bertipe INT64. 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_DIFF?
Fungsi ini memiliki 3 parameter wajib. Parameter yang digunakan: datetime_expression_a (DATETIME, wajib): DATETIME akhir (minuend); datetime_expression_b (DATETIME, wajib): DATETIME awal (subtrahend); datetime_part (DATETIME_PART, wajib): Unit hasil: YEAR, MONTH, DAY, HOUR, MINUTE, SECOND, etc..
Kembali ke BigQuery Functions