Date & Time

TIME_SUB

BigQueryBigQuery

Subtracts a time interval from a TIME value. The inverse of TIME_ADD.

Tipe hasil: TIMEDiperbarui: 13 Jun 2026

Syntax

SQL
TIME_SUB(time_expression, INTERVAL int64_expression time_part)

Parameter

time_expressionTIMEwajib

The starting TIME value

int64_expressionINT64wajib

The number of intervals to subtract

time_partTIME_PARTwajib

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

Contoh Penggunaan

Subtract Hours

SQL
1SELECT
2  TIME '17:00:00' as end_time,
3  TIME_SUB(TIME '17:00:00', INTERVAL 8 HOUR) as start_time,
4  TIME_SUB(TIME '17:00:00', INTERVAL 30 MINUTE) as before_end;

Subtract hours and minutes from a time value.

Hasil
end_timestart_timebefore_end
17:00:0009:00:0016:30:00

Before Midnight Wrap

SQL
1SELECT
2  TIME '02:00:00' as early_morning,
3  TIME_SUB(TIME '02:00:00', INTERVAL 5 HOUR) as yesterday_night;

The result wraps back to the previous day.

Hasil
early_morningyesterday_night
02:00:0021:00:00

Pertanyaan Umum tentang TIME_SUB

Apa itu fungsi TIME_SUB di BigQuery?
Subtracts a time interval from a TIME value. The inverse of TIME_ADD. Di BigQuery, fungsi TIME_SUB termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan TIME_SUB di BigQuery?
Gunakan sintaks berikut: TIME_SUB(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_SUB?
Fungsi TIME_SUB 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_SUB?
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 subtract; time_part (TIME_PART, wajib): Interval unit: HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND.
Ngulik Langsung

Sudah paham TIME_SUB? Latih langsung di browser

Latihan interaktif, langsung di browser.

Latihan Langsung →
Kembali ke BigQuery Functions