All Products
Search
Document Center

Quick BI:Fungsi Tanggal

Last Updated:Feb 10, 2026

Fungsi tanggal digunakan dalam analitik data untuk memproses tanggal dan waktu, termasuk memformat tanggal, menghitung selisih antar tanggal, mengembalikan timestamp saat ini, serta menambah atau mengurangi satuan waktu. Topik ini menjelaskan cara menggunakan fungsi tanggal bawaan.

BI_DATEADD

BI_DATEADD mengembalikan tanggal setelah penambahan interval waktu tertentu.

Sintaks

BI_DATEADD(date, interval, date_part)

Parameter

  • date: Tanggal yang akan dikembalikan.

  • interval: Menentukan interval waktu.

  • date_part: Satuan waktu. Nilai yang didukung (tidak peka huruf besar/kecil) adalah:

    year: year

    quarter: quarter

    Month

    Week

    Day

    hour: hour

    Minute: minute

    second: second

Definisi

Mengembalikan tanggal baru yang dihitung dengan menambahkan <interval> tertentu ke bagian <date_part> dari suatu tanggal.

Keluaran

Date

Contoh

BI_DATEADD('2020-09-29', 100, 'day') = 2021-01-07

Batasan

Tidak didukung untuk sumber data Lindorm (LindormTSDB).

Hanya didukung untuk sumber data Lindorm (LindormTable, multi-model SQL) versi 2.8 dan yang lebih baru.

BI_DATEDIFF

BI_DATEDIFF mengembalikan selisih antara dua tanggal.

Sintaks

BI_DATEDIFF(date1, date2, date_part)

Parameter

  • date1: Tanggal input pertama.

  • date2: Tanggal input kedua.

  • date_part: Satuan waktu untuk hasil perhitungan. Nilai yang didukung (tidak peka huruf besar/kecil) adalah:

    year: year

    Quarter

    month: month

    Week

    Day

    Hour

    minute: minute

    second: second

Definisi

Mengembalikan selisih antara <date1> dan <date2>, dinyatakan dalam satuan penuh <date_part>.

Output

Integer

Contoh

BI_DATEDIFF('2024-05-22', '2020-09-29', 'year') = 3

Artinya terdapat tiga tahun penuh antara 29 September 2020 dan 22 Mei 2024.

Batasan

Tidak didukung untuk sumber data Lindorm (LindormTSDB).

Hanya didukung untuk sumber data Lindorm (LindormTable, multi-model SQL) versi 2.8 dan yang lebih baru.

BI_DATETRUNC

BI_DATETRUNC memotong tanggal ke tingkat tertentu—seperti day, month, quarter, atau year—dan mengembalikan tanggal pertama pada tingkat tersebut.

Sintaks

BI_DATETRUNC(date, date_part)

Parameter

  • date: Tanggal yang akan dikembalikan.

  • date_part: Satuan waktu untuk pemotongan. Nilai yang didukung (tidak peka huruf besar/kecil) adalah:

    Year

    Quarter

    month: month

    Week: week

    day: day

    Hour

    Minute: minute

    Second

Definisi

Memotong <date> ke presisi <date_part>. Misalnya, memotong ke month mengembalikan hari pertama bulan tersebut.

Keluaran

Date

Contoh

BI_DATETRUNC('2020-09-29', 'day') = 2020-09-29

BI_DATETRUNC('2020-09-29', 'quarter') = 2020-07-01

Batasan

Tidak didukung untuk sumber data Lindorm.

BI_DAY

BI_DAY mengembalikan hari dalam bulan dari suatu tanggal.

Sintaks

BI_DAY(date)

Deskripsi parameter

date: Tanggal yang akan dikembalikan.

Definisi

Mengembalikan hari dalam bulan dari <date> sebagai bilangan bulat.

Keluaran

Integer

Contoh

BI_DAY('2020-09-29') = 29

BI_DAYOFWEEK

Sintaks

BI_DAYOFWEEK(date, <start>)

Parameter

  • date: Tanggal input.

  • start: Hari pertama dalam minggu. Nilai default adalah "Mon". Nilai yang didukung (tidak peka huruf besar/kecil) adalah:

    Mon: Monday

    Tue: Tuesday

    Wed: Wednesday

    Thu: Thursday

    Fri: Friday

    Sat: Saturday

    Sun: Sunday

Definisi

Mengembalikan nomor hari <date> dalam minggunya.

Minggu dimulai pada <start>. Parameter <start> bersifat opsional dan default-nya adalah "Mon".

Keluaran

Number

Contoh

BI_DAYOFWEEK("2024-05-22", "Mon") = 3

BI_DAYOFWEEK("2024-09-29", "Mon") = 7

BI_MAKEDATE

BI_MAKEDATE membuat tanggal berdasarkan nilai tahun, bulan, dan hari.

Sintaks

BI_MAKEDATE(year, month, day)

Parameter

  • year: Nilai tahun.

  • month: Nilai bulan.

  • day: Komponen hari.

Definisi

Mengembalikan tanggal yang dibuat dari <year>, <month>, dan <day>.

Keluaran

Date

Contoh

BI_MAKEDATE(2020, 9, 29) = 2020-09-29

Batasan

Hanya didukung untuk sumber data Lindorm (LindormTable, multi-model SQL) versi 2.8 dan yang lebih baru.

BI_MONTH

BI_MONTH mengembalikan bulan dari suatu tanggal.

Sintaks

BI_MONTH(date)

Deskripsi parameter

date: Hari dalam bulan yang akan dikembalikan.

Definisi

Mengembalikan bulan dari <date> sebagai bilangan bulat.

Keluaran

Integer

Contoh

BI_MONTH('2020-09-29') = 9

BI_NOW

BI_NOW mengembalikan waktu saat ini.

Sintaks

BI_NOW()

Definisi

Mengembalikan waktu saat ini.

Keluaran

Date

Contoh

BI_NOW() = 2024-05-22 09:29:29

BI_QUARTER

BI_QUARTER mengembalikan kuartal dari suatu tanggal.

Sintaks

BI_QUARTER(date)

Deskripsi parameter

date: Tanggal yang menentukan kuartal yang akan dikembalikan.

Definisi

Mengembalikan kuartal dari <date> sebagai bilangan bulat.

Keluaran

Integer

Contoh

BI_QUARTER('2020-09-29') = 3

BI_TODAY

BI_TODAY mengembalikan tanggal saat ini.

Sintaks

BI_TODAY()

Definisi

Mengembalikan tanggal saat ini.

Keluaran

Date

Contoh

BI_TODAY() = 2024-05-22

BI_WEEK

BI_WEEK mengembalikan nomor minggu dari suatu tanggal.

Sintaks

BI_WEEK(date)

Deskripsi parameter

date: Tanggal untuk minggu yang akan dikembalikan.

Definisi

Mengembalikan nomor minggu dari <date> sebagai bilangan bulat.

Keluaran

Integer

Contoh

BI_WEEK('2010-01-01') = 52

BI_WEEK('2010-01-06') = 1

BI_YEAR

BI_YEAR mengembalikan tahun dari suatu tanggal.

Sintaks

BI_YEAR(date)

Parameter

date: Tanggal dari mana tahun akan diekstraksi.

Definisi

Mengembalikan tahun dari <date> sebagai bilangan bulat.

Keluaran

Integer

Contoh

BI_YEAR('2020-09-29') = 2020