Date & Time

TIMESTAMP_ADD

BigQueryBigQuery

Menambahkan interval waktu ke TIMESTAMP. Hasil tetap dalam UTC.

Tipe hasil: TIMESTAMPDiperbarui: 16 Mei 2026

Syntax

SQL
TIMESTAMP_ADD(timestamp_expression, INTERVAL int64_expression timestamp_part)

Parameter

timestamp_expressionTIMESTAMPwajib

TIMESTAMP awal

int64_expressionINT64wajib

Jumlah interval yang ditambahkan

timestamp_partTIMESTAMP_PARTwajib

Unit interval: DAY, HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND

Contoh Penggunaan

Add Hours

SQL
1SELECT
2 TIMESTAMP '2024-01-15 10:00:00 UTC' as original,
3 TIMESTAMP_ADD(TIMESTAMP '2024-01-15 10:00:00 UTC', INTERVAL 6 HOUR) as plus_6h;

Menambahkan jam ke timestamp.

Hasil
originalplus_6h
2024-01-15 10:00:00 UTC2024-01-15 16:00:00 UTC

Token Expiration

SQL
1SELECT
2 user_id,
3 login_time,
4 TIMESTAMP_ADD(login_time, INTERVAL 24 HOUR) as token_expires
5FROM `project.dataset.user_sessions`;

Hitung waktu expiry token.

Pertanyaan Umum tentang TIMESTAMP_ADD

Apa itu fungsi TIMESTAMP_ADD di BigQuery?
Menambahkan interval waktu ke TIMESTAMP. Hasil tetap dalam UTC. Di BigQuery, fungsi TIMESTAMP_ADD termasuk dalam kelompok fungsi yang sering digunakan untuk mengolah dan menganalisis data secara efisien.
Bagaimana cara menggunakan TIMESTAMP_ADD di BigQuery?
Gunakan sintaks berikut: TIMESTAMP_ADD(timestamp_expression, INTERVAL int64_expression timestamp_part). Pastikan argumen yang dimasukkan sudah sesuai dengan tipe data yang diharapkan.
Apa nilai yang dikembalikan oleh fungsi TIMESTAMP_ADD?
Fungsi TIMESTAMP_ADD mengembalikan nilai bertipe TIMESTAMP. 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 TIMESTAMP_ADD?
Fungsi ini memiliki 3 parameter wajib. Parameter yang digunakan: timestamp_expression (TIMESTAMP, wajib): TIMESTAMP awal; int64_expression (INT64, wajib): Jumlah interval yang ditambahkan; timestamp_part (TIMESTAMP_PART, wajib): Unit interval: DAY, HOUR, MINUTE, SECOND, MILLISECOND, MICROSECOND.