Hologres：Fungsi Tanggal dan Waktu

TO_CHAR

• Deskripsi:

  • Mengonversi timestamp menjadi string. Secara default, hanya timestamp dalam rentang tahun 1925 hingga 2282 yang dapat dikonversi.

    TO_CHAR(TIMESTAMP|TIMESTAMPTZ, TEXT)

    Catatan penggunaan:

    • Anda dapat menggunakan fungsi ini untuk mengonversi timestamp menjadi string dalam format 24 jam atau 12 jam. HH24 menunjukkan format 24 jam, dan HH12 menunjukkan format 12 jam. Secara default, format 12 jam digunakan.

    • YYYY sesuai dengan tahun, MM ke bulan, DD ke hari, HH ke jam, MI ke menit, dan SS ke detik.

    • Mulai dari Hologres V1.1.31, Anda dapat menjalankan set hg_experimental_functions_use_pg_implementation = 'to_char'; atau set hg_experimental_functions_use_pg_implementation = 'to_char,to_date,to_timestamp'; sebelum pernyataan SQL untuk mendukung semua rentang waktu.

      Catatan

      Jika Anda menjalankan salah satu pernyataan tersebut untuk mengonfigurasi parameter GUC, kinerja query akan menurun sekitar 50%. Pada Hologres V1.1.42 dan versi lebih baru, kinerja query menurun sekitar 20%.

  • Mengonversi integer menjadi string.

    TO_CHAR(INT, TEXT)

  • Mengonversi bilangan real atau bilangan presisi ganda menjadi string.

    TO_CHAR(DOUBLE PRECISION, TEXT)

• Nilai Kembali:

  Nilai bertipe TEXT dikembalikan.

• Contoh:

  • Mengonversi timestamp menjadi string dalam format 24 jam.

    -- Hasil yang dikembalikan: 13:48:30.
    SELECT TO_CHAR(current_timestamp, 'HH24:MI:SS');
    
    -- Hasil yang dikembalikan: 2024-08-05.
    SELECT TO_CHAR(current_timestamp, 'YYYY-MM-DD');

  • Mengonversi timestamp menjadi string dalam format 12 jam.

    -- Hasil yang dikembalikan: 01:50:42 PM.
    SELECT TO_CHAR(current_timestamp, 'HH12:MI:SS AM');
    
    -- Hasil yang dikembalikan: 12:30:00 AM.
    SELECT TO_CHAR(time '00:30:00', 'HH12:MI:SS AM');

  • Mengonversi nilai timestamp dari sebuah kolom menjadi string.

    CREATE TABLE time_test(
      a text,
      b TIMESTAMPTZ );
    INSERT INTO time_test VALUES ('2001-09-28 03:00:00','2004-10-19 10:23:54+08');
    
    -- Hasil yang dikembalikan: 10:23:54.
    SELECT TO_CHAR(b, 'HH24:MI:SS') FROM time_test;
    
    -- Mengonversi nilai bertipe TEXT menjadi tanggal. Hasil yang dikembalikan: 2001-09-28.
    SELECT TO_CHAR(to_timestamp(a, 'YYYY-MM-DD'),'YYYY-MM-DD')FROM time_test;

  • Mengonversi timestamp menjadi string di zona waktu lain.

    CREATE TABLE timestamptz_test(
      a TIMESTAMPTZ);
    
    INSERT INTO timestamptz_test VALUES ('2023-03-21 10:23:54+02');

    • Jika tidak ada zona waktu yang ditentukan, nilai timestamp dari kolom a akan dikonversi menjadi string menggunakan zona waktu UTC+8.

      -- Hasil yang dikembalikan: 2023-03-21 16:23:54.
      SELECT TO_CHAR(a, 'YYYY-MM-DD HH24:MI:SS') FROM timestamptz_test;

    • Mengonversi nilai timestamp dari kolom a menjadi string yang menggunakan zona waktu UTC-5.

      -- Hasil yang dikembalikan: 2023-03-21 04:23:54.
      SELECT TO_CHAR(a at time zone 'US/Eastern', 'YYYY-MM-DD HH24:MI:SS') FROM timestamptz_test;

  • Mengonversi integer menjadi string.

    -- Hasil yang dikembalikan: 125.
    SELECT TO_CHAR(125, '999');

  • Mengonversi bilangan presisi ganda menjadi string.

    -- Hasil yang dikembalikan: 125.8.
    SELECT TO_CHAR(125.8::real, '999D9');

TO_DATE

• Deskripsi: Mengonversi string menjadi tanggal. Secara default, hanya string dalam rentang tahun 1925 hingga 2282 yang dapat dikonversi.

  TO_DATE(<text_date> TEXT, <format_mask> TEXT)

• Catatan penggunaan:

  Mulai dari Hologres V1.1.31, Anda dapat menjalankan set hg_experimental_functions_use_pg_implementation = 'to_date'; atau set hg_experimental_functions_use_pg_implementation = 'to_char,to_date,to_timestamp'; sebelum pernyataan SQL untuk mendukung semua rentang waktu.

  Catatan

  Jika Anda menjalankan salah satu pernyataan tersebut untuk mengonfigurasi parameter GUC, kinerja query akan menurun sekitar 50%. Pada Hologres V1.1.42 dan versi lebih baru, kinerja query menurun sekitar 20%.

• Parameter:

  • text_date: wajib. String yang ingin Anda konversi.

  • format_mask: wajib. Format tanggal.

• Nilai kembali:

  Nilai bertipe TEXT dikembalikan.

• Contoh:

  • Mengonversi string menjadi tanggal.

    -- Hasil yang dikembalikan: 2000-12-05.
    SELECT TO_DATE('05 Dec 2000', 'DD Mon YYYY');
    
    -- Hasil yang dikembalikan: 2001-03-24.
    SELECT TO_DATE('2001 03 24', 'YYYY-MM-DD');

  • Mengonversi nilai kolom bertipe TEXT menjadi tanggal.

    CREATE TABLE time_test(a TEXT);
    INSERT INTO time_test VALUES ('2001-09-28 03:00:00');
    SELECT TO_DATE(a, 'YYYY-MM-DD') FROM time_test;

    Hasil berikut dikembalikan:

      to_date
    ------------
     2001-09-28

TO_TIMESTAMP

• Deskripsi:

  • Mengonversi string menjadi timestamp. Secara default, hanya string dalam rentang tahun 1925 hingga 2282 yang dapat dikonversi.

    TO_TIMESTAMP(<text_date> TEXT, <format_mask> TEXT)

    • Catatan penggunaan:

      • Nilai kembali mencakup +08.

      • Mulai dari Hologres V1.1.31, Anda dapat menjalankan set hg_experimental_functions_use_pg_implementation = 'to_timestamp'; atau set hg_experimental_functions_use_pg_implementation = 'to_char,to_date,to_timestamp'; sebelum pernyataan SQL untuk mendukung semua rentang waktu.

        Catatan

        Jika Anda menjalankan salah satu pernyataan tersebut untuk mengonfigurasi parameter GUC, kinerja query akan menurun sekitar 50%. Pada Hologres V1.1.42 dan versi lebih baru, kinerja query menurun sekitar 20%.

    • Parameter:

      • text_date: wajib. String yang ingin Anda konversi menjadi timestamp.

      • format_mask: wajib. Format timestamp.

  • Mengonversi timestamp menjadi tanggal.

    TO_TIMESTAMP(DOUBLE PRECISION)

    Catatan

    Timestamp UNIX mewakili jumlah detik yang telah berlalu sejak 00:00:00, 1 Januari 1970.

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  • Mengonversi string menjadi timestamp.

    SELECT TO_TIMESTAMP('05 Dec 2000', 'DD Mon YYYY');

    Hasil berikut dikembalikan:

          to_timestamp
    ------------------------
     2000-12-05 00:00:00+08

  • Mengonversi string bertipe TEXT menjadi timestamp.

    CREATE TABLE time_test(a TEXT);
    INSERT INTO time_test VALUES ('2001-09-28 03:00:00');
    SELECT TO_TIMESTAMP(a, 'YYYY-MM-DD') FROM time_test;

    Hasil berikut dikembalikan:

          to_timestamp
    ------------------------
     2001-09-28 00:00:00+08

  • Mengonversi timestamp UNIX dalam detik menjadi tanggal.

    -- Hasil yang dikembalikan: 1975-03-06 03:38:16+08.
    SELECT TO_TIMESTAMP(163280296);

  • Mengonversi timestamp UNIX dalam milidetik menjadi tanggal.

    -- Hasil yang dikembalikan: 2021-09-28 12:22:41+08.
    SELECT TO_TIMESTAMP(1632802961000/1000);

MAKE_DATE

• Deskripsi: Membuat tanggal dari tahun, bulan, dan hari. Secara default, hanya nilai dalam rentang tahun 1925 hingga 2282 yang didukung.

  MAKE_DATE(<year> INT, <month> INT, <day> INT)

• Catatan penggunaan:

  Hologres V2.0.29 dan versi lebih baru mendukung fungsi ini. Fungsi ini tidak mendukung konstanta sebagai parameter input.

• Nilai kembali:

  Nilai bertipe DATE dikembalikan.

• Contoh:

  -- Hasil yang dikembalikan: 2013-07-15.
  SELECT MAKE_DATE(2013, 7, 15);

  Hasil berikut dikembalikan:

  make_date
  ------------
   2013-07-15

DATEADD

• Deskripsi: Menambahkan atau mengurangi interval ke atau dari nilai tanggal dan waktu tertentu berdasarkan unit waktu yang ditentukan. Secara default, hanya nilai dalam rentang tahun 1925 hingga 2282 yang didukung.

  DATEADD(<d> DATE|TIMESTAMP|TIMESTAMPTZ, <num> BIGINT, <str> TEXT)

• Catatan penggunaan:

  Instansi Hologres dengan versi berikut mendukung fungsi ini:

  • V2.0.31 hingga V2.1.0

  • V2.1.13 dan versi lebih baru

  Catatan

  Fungsi ini tidak mendukung semua parameter input sebagai konstanta.

• Parameter:

  • d: wajib. Nilai tanggal dan waktu asli.

  • num: wajib. Interval yang ingin Anda tambahkan atau kurangi.

  • str: wajib. Unit waktu yang ditentukan. Nilai valid: yyyy, year, mm, month, mon, dd, day, hh, hour, mi, dan ss.

• Nilai kembali:

  Nilai bertipe DATE, TIMESTAMP, atau TIMESTAMPTZ dikembalikan.

• Contoh:

  CREATE TABLE test_dateadd (a TIMESTAMP);
  INSERT INTO test_dateadd VALUES ('2005-02-28 00:00:00');
  
  -- Menambahkan satu bulan ke nilai tanggal dan waktu yang ditentukan.
  SELECT DATEADD(a , 1, 'mm') FROM test_dateadd;

  Hasil berikut dikembalikan:

         dateadd
  ---------------------
   2005-03-28 00:00:00

ADD_MONTHS

• Deskripsi: Menambahkan sejumlah bulan tertentu ke nilai tanggal dan waktu tertentu. Fungsi ini kompatibel dengan Oracle. Sebelum menggunakan fungsi ini, Anda harus menginstal ekstensi Orafce. Untuk informasi lebih lanjut, lihat Fungsi Oracle yang didukung.

  ADD_MONTHS(<d> DATE, <month> INT)

• Parameter:

  • d: wajib. Tanggal asli.

  • month: wajib. Bilangan bulat yang ingin Anda tambahkan ke tanggal asli.

• Nilai kembali:

  Nilai bertipe DATE dikembalikan.

• Contoh:

  SELECT ADD_MONTHS(current_date, 2);

  Hasil berikut dikembalikan:

   add_months
  ------------
   2024-10-05

DATEDIFF

• Deskripsi: Menghitung perbedaan antara dua tanggal atau timestamp. Secara default, hanya nilai dalam rentang tahun 1925 hingga 2282 yang didukung.

  DATEDIFF(<d1> DATE|TIMESTAMP|TIMESTAMPTZ, <d2> DATE|TIMESTAMP|TIMESTAMPTZ, <str> TEXT)

• Catatan penggunaan:

  Instansi Hologres dengan versi berikut mendukung fungsi ini:

  • V2.0.31 hingga V2.1.0

  • V2.1.13 dan versi lebih baru

  Catatan

  Parameter input fungsi ini tidak dapat semuanya berupa konstanta.

• Parameter:

  • d1: wajib. Tanggal atau timestamp pertama.

  • d2: wajib. Tanggal atau timestamp kedua.

  • str: wajib. Unit waktu berdasarkan mana selisih waktu dihitung. Nilai valid: yyyy, year, mm, month, mon, dd, day, hh, hour, mi, dan ss.

• Nilai kembali:

  Nilai bertipe BIGINT dikembalikan. Jika selisih waktu dalam unit waktu yang ditentukan kurang dari 1, nilai 0 akan dikembalikan secara default.

  Sebagai contoh, jika Anda menggunakan fungsi ini untuk menghitung selisih antara 2023-12-31 dan 2024-01-01 berdasarkan unit waktu tahun, nilai 0 akan dikembalikan.

  Catatan

  Jika Anda ingin fungsi tersebut mengembalikan 1 dalam skenario sebelumnya, jalankan set hg_experimental_datediff_use_presto_impl = off; sebelum pernyataan SQL untuk menonaktifkan parameter GUC ini.

• Contoh:

  CREATE TABLE test_datediff (a TIMESTAMP);
  INSERT INTO test_datediff VALUES ('2005-02-28 00:00:00');
  
  -- Menghitung selisih dalam menit antara dua tanggal.
  SELECT DATEDIFF(a , '2005-03-02 00:00:00', 'mi') FROM test_datediff;

  Hasil berikut dikembalikan:

   datediff
  ----------
      -2880

MONTHS_BETWEEN

• Deskripsi: Mengembalikan jumlah bulan antara dua tanggal. Fungsi ini kompatibel dengan Oracle. Sebelum menggunakan fungsi ini, Anda harus menginstal ekstensi Orafce. Untuk informasi lebih lanjut, lihat Fungsi Oracle yang didukung.

  MONTHS_BETWEEN(DATE, DATE)

• Nilai kembali:

  Nilai bertipe INT dikembalikan.

• Contoh:

  • Contoh 1:

    -- Hasil yang dikembalikan: 2.
    SELECT MONTHS_BETWEEN('2022-01-01', '2021-11-01');

  • Contoh 2:

    -- Hasil yang dikembalikan: -2.
    SELECT MONTHS_BETWEEN('2021-11-01', '2022-01-01');

NEXT_DAY

• Deskripsi: Mengembalikan tanggal hari pertama yang ditentukan setelah tanggal tertentu. Fungsi ini kompatibel dengan Oracle. Sebelum menggunakan fungsi ini, Anda harus menginstal ekstensi Orafce. Untuk informasi lebih lanjut, lihat Fungsi Oracle yang didukung.

  NEXT_DAY(<d> DATE, <str> TEXT|INT)

• Parameter:

  • d: wajib. Tanggal yang ditentukan.

  • str: wajib. String yang mewakili hari dalam seminggu. Contoh: Friday. Parameter ini juga dapat diatur ke angka yang mewakili hari dalam seminggu. Angka berkisar dari 1 hingga 7. Nilai 1 menunjukkan Minggu, dan nilai 2 menunjukkan Senin. Dengan cara serupa, nilai 7 menunjukkan Sabtu.

• Nilai kembali:

  Nilai bertipe DATE dikembalikan.

• Contoh:

  • Contoh 1:

    -- Hasil yang dikembalikan: 2022-05-06.
    SELECT NEXT_DAY('2022-05-01', 'FRIDAY');

  • Contoh 2:

    -- Hasil yang dikembalikan: 2022-05-06.
    SELECT NEXT_DAY('2022-05-01', 5);

Penambahan tanggal dan waktu: +

SELECT date '2001-09-28' + integer '7';

SELECT current_date+ integer '3 ';

SELECT to_char(current_date+ interval '1 day','yyyy-mm-dd');

SELECT date '2001-09-28' + time '03:00';

SELECT date '2001-09-28' + interval '1 hour';

SELECT now()+interval '1 day';

SELECT now()+interval '1 month';

 SELECT now()+interval '2 year';

Pengurangan tanggal dan waktu: -

SELECT date '2001-10-01' - date '2001-09-28';

SELECT date '2001-10-01' - integer '7';

SELECT date '2001-09-28' - time '03:00';

 SELECT date '2001-09-28' - interval '1 hour';

SELECT now()-interval '2 day';

Perkalian tanggal dan waktu: *

SELECT 21 * interval '3 day';

Pembagian tanggal dan waktu: /

SELECT interval '1 hour' / double precision '1.5';

Fungsi pemotongan tanggal dan waktu

CURRENT_DATE

• Deskripsi: Mengembalikan tanggal saat ini.

  CURRENT_DATE

• Nilai kembali:

  Nilai bertipe DATE dikembalikan.

• Contoh:

  SELECT CURRENT_DATE;

  Hasil berikut dikembalikan:

   current_date
  --------------
   2024-08-08

CURRENT_TIMESTAMP

• Deskripsi: Mengembalikan waktu mulai transaksi saat ini. Fungsi ini setara dengan fungsi TRANSACTION_TIMESTAMP atau NOW.

  CURRENT_TIMESTAMP

  Catatan

  Nilai kembali tetap tidak berubah selama siklus hidup transaksi.

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  SELECT CURRENT_TIMESTAMP;

  Hasil berikut dikembalikan:

         current_timestamp
  -------------------------------
   2024-08-08 14:55:11.006068+08

CLOCK_TIMESTAMP

• Deskripsi: Mengembalikan tanggal dan waktu saat ini.

  clock_timestamp()

  Catatan

  Perubahan juga dapat dilakukan dalam satu perintah.

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  SELECT clock_timestamp();

  Hasil berikut dikembalikan:

          clock_timestamp
  -------------------------------
   2024-08-08 14:57:43.569109+08

LOCALTIMESTAMP

• Deskripsi: Mengembalikan waktu saat ini tanpa informasi zona waktu.

  LOCALTIMESTAMP

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  SELECT LOCALTIMESTAMP;

  Hasil berikut dikembalikan:

        localtimestamp
  ---------------------------
   2024-08-08 15:00:59.13245

NOW

• Deskripsi: Mengembalikan waktu mulai transaksi saat ini. Fungsi ini setara dengan fungsi TRANSACTION_TIMESTAMP atau CURRENT_TIMESTAMP.

  NOW()

  Catatan

  Nilai kembali tetap tidak berubah selama siklus hidup transaksi.

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  SELECT NOW();

  Hasil berikut dikembalikan:

                now
  -------------------------------
   2024-08-08 15:02:50.270501+08

STATEMENT_TIMESTAMP

• Deskripsi: Mengembalikan waktu mulai pernyataan saat ini.

  STATEMENT_TIMESTAMP()

  Catatan

  Nilai kembali bervariasi berdasarkan pernyataan dalam transaksi tempat fungsi digunakan.

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  SELECT STATEMENT_TIMESTAMP();

  Hasil berikut dikembalikan:

        statement_timestamp
  -------------------------------
   2024-08-08 15:06:14.772939+08

TIMEOFDAY

• Deskripsi: Mengembalikan tanggal dan waktu saat ini. Fungsi ini mirip dengan fungsi CLOCK_TIMESTAMP. Nilai yang dikembalikan oleh fungsi TIMEOFDAY adalah string teks yang diformat.

  TIMEOFDAY()

• Nilai kembali:

  Nilai bertipe TEXT dikembalikan.

• Contoh:

  SELECT TIMEOFDAY();

  Hasil berikut dikembalikan:

                timeofday
  -------------------------------------
   Thu Aug 08 15:08:16.599369 2024 CST

TRANSACTION_TIMESTAMP

• Deskripsi: Mengembalikan waktu mulai transaksi saat ini. Fungsi ini setara dengan fungsi CURRENT_TIMESTAMP atau NOW.

  TRANSACTION_TIMESTAMP()

  Catatan

  Nilai kembali tetap tidak berubah selama siklus hidup transaksi.

• Nilai kembali:

  Nilai bertipe TIMESTAMPTZ dikembalikan.

• Contoh:

  SELECT TRANSACTION_TIMESTAMP();

  Hasil berikut dikembalikan:

       transaction_timestamp
  -------------------------------
   2024-08-08 15:11:10.329005+08

ISFINITE

• Deskripsi:

  • Memeriksa apakah tanggal bertipe DATE merupakan angka terbatas.

    ISFINITE(DATE)

  • Memeriksa apakah timestamp merupakan angka terbatas.

    ISFINITE(TIMESTAMP)

• Nilai kembali:

  Nilai bertipe BOOLEAN dikembalikan. Nilai true (t) dikembalikan jika tanggal atau timestamp merupakan angka terbatas, dan nilai false (f) dikembalikan jika tanggal atau timestamp bukan angka terbatas.

• Contoh:

  • Contoh 1:

    SELECT ISFINITE(date '2001-02-16');

    Hasil berikut dikembalikan:

     isfinite
    ----------
     t

  • Contoh 2:

    SELECT ISFINITE(timestamp '2001-02-16 21:28:30');

    Hasil berikut dikembalikan:

     isfinite
    ----------
     t