全部产品
Search
文档中心

Quick BI:Fungsi Tanggal

更新时间:Sep 04, 2025

Fungsi tanggal digunakan dalam analitik data untuk memproses tanggal dan waktu. Fungsi ini dapat digunakan untuk memformat tanggal, menghitung selisih antara dua tanggal, mendapatkan cap waktu saat ini, menambah atau mengurangi unit waktu, serta keperluan lainnya. Topik ini menjelaskan cara menggunakan fungsi tanggal dalam sistem fungsi bawaan.

BI_DATEADD

BI_DATEADD mengembalikan tanggal setelah menambahkan interval waktu tertentu.

Sintaksis

BI_DATEADD(date, interval, date_part)

Parameter

  • date: Tanggal yang akan dikembalikan.

  • interval: Interval waktu yang ditentukan.

  • date_part: Unit waktu yang ditentukan, mendukung unit waktu berikut (tidak peka huruf besar/kecil):

    year: tahun

    quarter: kuartal

    month: Bulan

    week: minggu

    day: hari

    hour: jam

    minute: menit

    Second: detik

Definisi

Mengembalikan tanggal setelah menambahkan jumlah <interval> tertentu ke <bagian_tanggal> dari tanggal tersebut.

Keluaran

Date

Contoh

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

BI_DATEDIFF

BI_DATEDIFF mengembalikan selisih waktu antara dua tanggal.

Sintaksis

BI_DATEDIFF(date1, date2, date_part)

Parameter

  • tanggal1: Tanggal pertama yang akan dikembalikan.

  • tanggal2: Tanggal kedua yang akan dikembalikan.

  • date_part: Unit waktu yang akan dikembalikan, mendukung unit waktu berikut (tidak peka huruf besar/kecil):

    Year: tahun

    quarter: kuartal

    month: Bulan

    week: minggu

    day: hari

    hour: jam

    minute: menit

    Second: detik

Definisi

Mengembalikan selisih antara <tanggal1> dan <tanggal2>. Dinyatakan dalam unit <bagian_tanggal>, hanya unit <bagian_tanggal> lengkap yang dihitung.

Keluaran

Integer

Contoh

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

Ini berarti ada 3 tahun penuh antara 29 September 2020 dan 22 Mei 2024.

BI_DATETRUNC

BI_DATETRUNC memotong tanggal sesuai dengan tingkat tertentu (hari, bulan, kuartal, tahun, dll.) untuk mendapatkan tanggal hari pertama dari tingkat yang ditentukan.

Sintaksis

BI_DATETRUNC(date, date_part)

Parameter

  • tanggal: Tanggal yang akan dikembalikan.

  • date_part: Unit waktu untuk memotong tanggal, mendukung unit waktu berikut (tidak peka huruf besar/kecil):

    year: Tahun

    quarter: kuartal

    Month: bulan

    week: minggu

    day: hari

    hour: jam

    minute: menit

    second: detik

Definisi

Memotong <tanggal> ke presisi yang ditentukan oleh <bagian_tanggal>. Sebagai contoh, ketika dipotong ke level bulan, fungsi ini 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

BI_DAY

BI_DAY mengembalikan hari dari sebuah tanggal.

Sintaksis

BI_DAY(date)

Parameter

tanggal: Tanggal dari mana hari akan dikembalikan.

Definisi

Mengembalikan hari dari <date> yang diberikan sebagai integer.

Keluaran

Integer

Contoh

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

BI_DAYOFWEEK

Sintaksis

BI_DAYOFWEEK(tanggal, <mulai>)

Parameter

  • tanggal: Tanggal dari mana hari dalam seminggu akan dikembalikan.

  • start: Menentukan hari awal dalam seminggu, default adalah "Mon", dengan korespondensi berikut (tidak peka huruf besar/kecil):

    Mon: Senin

    Tue: Selasa

    Wed: Rabu

    Thu: Kamis

    Fri: Jumat

    Sat: Sabtu

    Sun: Minggu

Definisi

Mengembalikan hari apa dalam seminggu <tanggal> tersebut.

Minggu dimulai dengan <mulai> sebagai hari pertama. <mulai> bersifat opsional dan defaultnya adalah "Mon".

Keluaran

Nilai numerik

Contoh

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

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

BI_MAKEDATE

BI_MAKEDATE membuat tanggal tertentu.

Sintaksis

BI_MAKEDATE(year, month, day)

Parameter

  • tahun: Tahun yang akan dibuat.

  • bulan: Bulan yang akan dibuat.

  • hari: Hari yang akan dibuat.

Definisi

Mengembalikan nilai tanggal yang dibuat dari <tahun>, <bulan>, dan <hari> yang ditentukan.

Keluaran

Date

Contoh

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

BI_MONTH

BI_MONTH mengembalikan bulan dari sebuah tanggal.

Sintaksis

BI_MONTH(date)

Parameter

tanggal: Tanggal dari mana bulan akan dikembalikan.

Definisi

Mengembalikan bulan dari <date> yang diberikan sebagai integer.

Keluaran

Integer

Contoh

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

BI_NOW

BI_NOW() mengembalikan waktu saat ini.

Sintaksis

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 sebuah tanggal.

Sintaksis

BI_QUARTER(date)

Parameter

tanggal: Tanggal dari mana kuartal akan dikembalikan.

Definisi

Mengembalikan kuartal dari <tanggal> yang diberikan sebagai bilangan bulat.

Keluaran

Integer

Contoh

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

BI_TODAY

BI_TODAY() mengembalikan tanggal saat ini.

Sintaksis

BI_TODAY()

Definisi

Mengembalikan tanggal saat ini.

Keluaran

Date

Contoh

BI_TODAY() = 2024-05-22

BI_WEEK

BI_WEEK mengembalikan minggu dari sebuah tanggal.

Sintaksis

BI_WEEK(date)

Parameter

tanggal: Tanggal dari mana minggu akan dikembalikan.

Definisi

Mengembalikan minggu dari <date> yang diberikan sebagai integer.

Keluaran

Integer

Contoh

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

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

BI_YEAR

BI_YEAR mengembalikan tahun dari sebuah tanggal.

Sintaksis

BI_YEAR(date)

Parameter

tanggal: Tanggal dari mana tahun akan dikembalikan.

Definisi

Mengembalikan tahun dari <date> yang diberikan sebagai integer.

Keluaran

Integer

Contoh

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