DataWorks：Format yang didukung untuk parameter penjadwalan

Prinsip penggunaan dasar

Anda dapat menentukan logika penugasan untuk parameter penjadwalan dengan mengatur nama parameter dan nilai parameter di bagian Scheduling > Scheduling Parameters. Setelah menentukan parameter, Anda dapat mereferensikannya dalam kode menggunakan format ${parameter_name}. Untuk informasi lebih lanjut tentang cara mengonfigurasi parameter, lihat Konfigurasikan dan gunakan parameter penjadwalan.

• Anda dapat langsung menggunakan parameter sistem bawaan $bizdate dan $cyctime masing-masing untuk tanggal bisnis dan waktu penjadwalan. Keduanya setara dengan yang berikut:

  • $bizdate = ${yyyymmdd}

  • $cyctime = $[yyyymmddhh24miss]

    Gambar berikut membandingkan definisi parameter untuk $bizdate dan ${yyyymmdd}, serta untuk $cyctime dan $[yyyymmddhh24miss]. Gambar tersebut juga menunjukkan hasil pratinjau ketika tanggal bisnis adalah 16 Oktober 2025.

• Jika nilai yang dikembalikan oleh parameter garis dasar waktu tidak memenuhi kebutuhan Anda, Anda dapat membuat parameter waktu kustom menggunakan ${...} dan $[...]. Parameter waktu kustom merupakan transformasi berdasarkan dua garis dasar waktu tersebut.

Perbedaan inti antara ${...} dan $[...]

Format ${...} dan $[...] memiliki perbedaan mendasar dalam garis dasar waktu dan kemampuan perhitungan. Menggunakan format yang salah akan menyebabkan error data.

Pemformatan waktu

Anda dapat menggunakan kurung kurawal ${...} atau kurung siku $[...] yang dikombinasikan dengan kombinasi kustom yyyy, yy, mm, dan dd untuk menghasilkan parameter waktu. Hal ini memungkinkan Anda mengambil tanggal N tahun, bulan, atau hari sebelum atau sesudah tanggal bisnis.

Perhitungan offset

Perhitungan offset merupakan fitur inti dari parameter dinamis yang memungkinkan Anda menambah atau mengurangi waktu dari tanggal bisnis atau waktu penjadwalan. Misalnya, Anda dapat mengambil tanggal N tahun, bulan, atau hari sebelum atau sesudah garis dasar. Anda juga dapat mengambil waktu N jam atau menit sebelum atau sesudah garis dasar, tetapi ini hanya didukung untuk waktu penjadwalan. Format ${...} dan $[...] mendukung rentang yang berbeda karena memiliki presisi garis dasar waktu yang berbeda.

1. Perhitungan offset dalam mode ${...}

   • Kemampuan inti: Mendukung offset bilangan bulat untuk tahun, bulan, minggu, dan hari.

     Penting

     Offset jam atau menit tidak didukung. Misalnya, sintaks seperti ${yyyy-mm-dd-1/24} tidak valid.

   • Sintaks: ${<format_waktu><±N>}. Dalam format ini, N berkorespondensi dengan unit terkecil dari format waktu. Misalnya, jika formatnya adalah yyyymm, N merepresentasikan offset dalam bulan (mm). Jika formatnya adalah yyyymmdd, N merepresentasikan offset dalam hari (dd).

     Periode offset tanggal	Offset Unit	Metode	Contoh
     N tahun sebelum/setelah	Tahun	${yyyy±N} atau ${yy±N}	Tahun sebelumnya: ${yyyy-1}
     N bulan sebelum/setelah	Bulan	${yyyymm±N}	Bulan sebelumnya: ${yyyymm-1}
     N minggu sebelum/setelah	Minggu	${yyyymmdd±7*N}	Minggu sebelumnya: ${yyyymmdd-7*1}
     N hari sebelum/setelah	Hari	${yyyymmdd±N}	Hari sebelum kemarin: ${yyyymmdd-1}

2. Perhitungan offset dalam mode $[...]

   • Kemampuan inti: Mendukung offset pecahan untuk hari, jam, dan menit.

     Penting

     Format $[...] tidak mendukung offset tahun atau bulan menggunakan format seperti $[yyyy-N] atau $[mm-N]. Untuk melakukan perhitungan offset pada tahun atau bulan, gunakan fungsi add_months.

   • Sintaks: $[<format_waktu><±N>]. Untuk menentukan offset jam, gunakan N/24. Untuk menentukan offset menit, gunakan N/24/60. Dalam ekspresi ini, N adalah jumlah jam atau menit untuk offset tersebut.

     Skenario	Satuan Offset	Metode	Contoh
     N tahun sebelum/setelah	Tahun	$[add_months(yyyymmdd,12*N)] (N tahun setelah) $[add_months(yyyymmdd,-12*N)] (N tahun sebelum)	Tahun sebelumnya: $[add_months(yyyymmdd,-12)]
     N bulan sebelum/setelah	Bulan	$[add_months(yyyymmdd,N)] (N bulan setelah) $[add_months(yyyymmdd,-N)] (N bulan sebelum)	Bulan sebelumnya: $[add_months(yyyymmdd,-1)]
     N minggu sebelum/setelah	Minggu	$[yyyymmdd±7*N]	Minggu sebelumnya: $[yyyymmdd±7*1]
     N hari sebelum/setelah	Hari	$[yyyymmdd±N]	Kemarin: $[yyyymmdd-1]
     N jam sebelum/setelah	Jam	Format yang tersedia: $[hh24miss±N/24], $[hh24±N/24] $[Custom time format±N/24].	Jam sebelumnya dalam berbagai format: Bulan: $[mm-1/24]. Tahun: $[yyyy-1/24]. Tahun dan bulan: $[yyyymm-1/24]. Tahun, bulan, dan hari: $[yyyymmdd-1/24]. Hari sebelumnya dan jam sebelumnya: $[yyyymmdd-1-1/24]
     N menit sebelum/setelah	Menit	Format yang tersedia: $[hh24miss±N/24/60] $[yyyymmddhh24miss±N/24/60] $[mi±N/24/60] $[custom time format±N/24/60]	15 menit sebelum waktu penjadwalan dalam berbagai format: $[yyyy-15/24/60] $[yyyymm-15/24/60] $[yyyymmdd-15/24/60] $[hh24-15/24/60] $[mi-15/24/60]
     Offset gabungan kompleks	Hari + Jam	$[yyyymmdd±N±M/24], dengan N sebagai offset hari dan M sebagai offset jam.	Contoh: Ambil hari sebelumnya dan jam sebelumnya → $[yyyymmdd-1-1/24]

     Catatan

     • Saat melakukan perhitungan offset untuk jam dan menit, masalah lintas hari (cross-day) dapat terjadi. Untuk informasi lebih lanjut tentang cara menangani penggantian parameter lintas hari, lihat Bagaimana cara menangani penggantian parameter lintas hari saat saya mengurangi satu jam dari parameter penjadwalan?.

     • Saat melakukan perhitungan offset bulan pada tanggal akhir bulan, jika bulan tujuan tidak memiliki tanggal tersebut, hasilnya secara otomatis dikalibrasi ke tanggal terakhir bulan tujuan. Misalnya, jika tanggal saat ini adalah 2025-03-31 dan Anda mengurangi satu bulan, hasilnya adalah 2025-02-28 karena Februari tidak memiliki tanggal 31.

Transformasi sekunder menggunakan fungsi engine

Jika fitur pemformatan dan offset bawaan tidak dapat menghasilkan nilai yang Anda butuhkan (misalnya, mengambil tanggal terakhir bulan sebelumnya), Anda dapat menggunakan fungsi bawaan dari mesin komputasi node target atau node penugasan untuk melakukan transformasi sekunder pada parameter waktu saat memanggilnya.

Untuk informasi lebih lanjut, lihat Skenario khas untuk pemrosesan sekunder nilai kembali parameter penjadwalan.

Penggabungan string

Anda dapat menggunakan metode ini untuk membangun string tanggal tertentu yang tidak didukung oleh sintaks bawaan tetapi mengikuti pola reguler. Metode ini menggabungkan bagian tanggal yang dihasilkan oleh parameter penjadwalan dengan string konstan tetap.

Skenario 1: Penjadwalan normal

Dalam skenario penjadwalan otomatis normal, logika penggantian parameter secara langsung berkorespondensi dengan dua garis dasar waktu: tanggal bisnis dan waktu penjadwalan.

• ${...} (tanggal bisnis): Nilainya ditentukan oleh tanggal bisnis instans tersebut.

• $[...] (waktu penjadwalan): Nilainya ditentukan oleh waktu penjadwalan instans tersebut.

Contoh: Asumsikan tugas penjadwalan harian A dijadwalkan berjalan pada pukul 00:00 setiap hari dan memiliki dua parameter yang dikonfigurasi:

• yesterday=${yyyymmdd}

• today=$[yyyymmddhh24miss]

Tabel berikut menunjukkan logika penggantian untuk salah satu instansnya.

Skenario 2: Pengisian ulang data

Saat Anda menjalankan tugas pengisian ulang data secara manual, logika penggantian parameter berubah berdasarkan tanggal bisnis yang dipilih secara manual, terutama untuk waktu penjadwalan.

• ${...} (tanggal bisnis): Garis dasarnya adalah tanggal bisnis yang dipilih secara manual.

• $[...] (waktu penjadwalan): Garis dasarnya adalah tanggal bisnis yang dipilih secara manual + 1 hari.

Contoh: Asumsikan Anda menjalankan pengisian ulang data secara manual untuk tugas A yang sama dan memilih tanggal bisnis 2025-03-15.