Date & Time

TIME_DIFF

BigQueryBigQuery

Menghitung selisih antara dua TIME dalam unit yang ditentukan.

Tipe hasil: INT64Diperbarui: 16 Mei 2026

Syntax

SQL
TIME_DIFF(time_expression_a, time_expression_b, time_part)

Parameter

time_expression_aTIMEwajib

TIME akhir (minuend)

time_expression_bTIMEwajib

TIME awal (subtrahend)

time_partTIME_PARTwajib

Unit hasil: HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND

Contoh Penggunaan

Calculate Work Hours

SQL
1SELECT
2 TIME '09:00:00' as clock_in,
3 TIME '17:30:00' as clock_out,
4 TIME_DIFF(TIME '17:30:00', TIME '09:00:00', HOUR) as work_hours,
5 TIME_DIFF(TIME '17:30:00', TIME '09:00:00', MINUTE) as work_minutes;

Hitung jam kerja.

Hasil
clock_inclock_outwork_hourswork_minutes
09:00:0017:30:008510

Meeting Duration

SQL
1SELECT
2 meeting_id,
3 start_time,
4 end_time,
5 TIME_DIFF(end_time, start_time, MINUTE) as duration_mins
6FROM `project.dataset.meetings`;

Hitung durasi meeting dalam menit.

Pertanyaan Umum tentang TIME_DIFF

Apa itu fungsi TIME_DIFF di BigQuery?
Menghitung selisih antara dua TIME dalam unit yang ditentukan. Di BigQuery, fungsi TIME_DIFF termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan TIME_DIFF di BigQuery?
Gunakan sintaks berikut: TIME_DIFF(time_expression_a, time_expression_b, time_part). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi TIME_DIFF?
Fungsi TIME_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 TIME_DIFF?
Fungsi ini memiliki 3 parameter wajib. Parameter yang digunakan: time_expression_a (TIME, wajib): TIME akhir (minuend); time_expression_b (TIME, wajib): TIME awal (subtrahend); time_part (TIME_PART, wajib): Unit hasil: HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND.