Date & Time

TIME_ADD

BigQueryBigQuery

Adds a time interval to a TIME value. Useful for work-hour calculations and scheduling.

Tipe hasil: TIMEDiperbarui: 13 Jun 2026

Syntax

SQL
TIME_ADD(time_expression, INTERVAL int64_expression time_part)

Parameter

time_expressionTIMEwajib

The starting TIME value

int64_expressionINT64wajib

The number of intervals to add

time_partTIME_PARTwajib

Interval unit: HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND

Contoh Penggunaan

Add Hours

SQL
1SELECT
2  TIME '09:00:00' as start_time,
3  TIME_ADD(TIME '09:00:00', INTERVAL 8 HOUR) as end_time,
4  TIME_ADD(TIME '09:00:00', INTERVAL 30 MINUTE) as break_time;

Add hours and minutes to a time value.

Hasil
start_timeend_timebreak_time
09:00:0017:00:0009:30:00

Wrap Around Midnight

SQL
1SELECT
2  TIME '23:00:00' as late_night,
3  TIME_ADD(TIME '23:00:00', INTERVAL 3 HOUR) as past_midnight;

The result wraps around to the next day.

Hasil
late_nightpast_midnight
23:00:0002:00:00

Pertanyaan Umum tentang TIME_ADD

Apa itu fungsi TIME_ADD di BigQuery?
Adds a time interval to a TIME value. Useful for work-hour calculations and scheduling. Di BigQuery, fungsi TIME_ADD termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan TIME_ADD di BigQuery?
Gunakan sintaks berikut: TIME_ADD(time_expression, INTERVAL int64_expression time_part). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi TIME_ADD?
Fungsi TIME_ADD mengembalikan nilai bertipe TIME. 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_ADD?
Fungsi ini memiliki 3 parameter wajib. Parameter yang digunakan: time_expression (TIME, wajib): The starting TIME value; int64_expression (INT64, wajib): The number of intervals to add; time_part (TIME_PART, wajib): Interval unit: HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND.
Ngulik Langsung

Sudah paham TIME_ADD? Latih langsung di browser

Latihan interaktif, langsung di browser.

Latihan Langsung →
Kembali ke BigQuery Functions