DataWorks：Format yang Didukung untuk Parameter Penjadwalan

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

Memahami perbedaan inti antara format ${...} dan $[...] sangat penting, karena mereka memiliki perbedaan mendasar dalam garis dasar waktu dan kemampuan perhitungan mereka. Mencampuradukkan keduanya dapat menyebabkan kesalahan data.

Pemformatan Waktu

Anda dapat memformat dua garis dasar waktu dengan menggunakan ${...} atau $[...] dikombinasikan dengan spesifikasi format waktu seperti yyyy, mm, dan dd.

Perhitungan Offset

Perhitungan offset adalah inti dari parameter dinamis, memungkinkan Anda menambah atau mengurangi waktu dari tanggal bisnis atau waktu penjadwalan. Misalnya, dapatkan tanggal N tahun, bulan, atau hari sebelum atau setelah garis dasar, atau N jam atau menit (jam dan menit hanya didukung untuk waktu penjadwalan). ${...} dan $[...] mendukung rentang yang berbeda karena presisi garis dasar waktu mereka yang berbeda.

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

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

     Penting

     Tidak mendukung offset jam atau menit. Sintaks seperti ${yyyy-mm-dd-1/24} tidak didukung.

   • Sintaks: ${<format_waktu><±N>}, di mana N sesuai dengan unit terkecil dari format waktu. Misalnya, jika formatnya adalah yyyymm, N mewakili bulan (mm); jika formatnya adalah yyyymmdd, N mewakili hari (dd).

     Periode offset tanggal	Unit offset	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 sebelumnya: ${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 sebagai gantinya.

   • Sintaks: $[<format_waktu><±N>], di mana offset jam ditentukan sebagai N/24 dan offset menit ditentukan sebagai N/24/60. N adalah jumlah jam atau menit untuk offset.

     Persyaratan	Unit 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*1)]
     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	Gunakan format seperti $[hh24miss±N/24], $[hh24±N/24], dan $[<format_waktu_kustom>±N/24].	Jam sebelumnya dalam format berbeda: $[mm-1/24], $[yyyy-1/24], $[yyyymm-1/24], $[yyyymmdd-1/24], $[yyyymmdd-1-1/24].
     N menit sebelum/setelah	Menit	Gunakan format seperti $[hh24miss±N/24/60], $[yyyymmddhh24miss±N/24/60], $[mi±N/24/60], atau $[<format_waktu_kustom>±N/24/60].	15 menit sebelum waktu penjadwalan dalam format berbeda: $[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], di mana N adalah offset hari dan M adalah offset jam.	Contoh: Dapatkan hari sebelumnya dan jam sebelumnya → $[yyyymmdd-1-1/24]

     Catatan

     Saat Anda melakukan perhitungan offset untuk jam dan menit, masalah lintas hari mungkin terjadi. Untuk detail tentang cara menangani penggantian parameter lintas hari, lihat Bagaimana cara menangani penggantian parameter lintas hari ketika saya mengurangi satu jam dari parameter penjadwalan?.

Transformasi sekunder menggunakan fungsi mesin

Jika fitur bawaan tidak dapat menghasilkan nilai yang Anda butuhkan (misalnya, mendapatkan hariterakhir dari bulan sebelumnya), gunakan 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 tipikal untuk pemrosesan sekunder nilai balik parameter penjadwalan.

Penggabungan String

Metode ini digunakan untuk membangun string tanggal tertentu yang tidak didukung oleh sintaksis bawaan. Ini menggabungkan bagian tanggal yang dihasilkan oleh parameter penjadwalan dengan string konstan tetap.

Penggantian parameter selama pengisian ulang data

Setelah Anda mengirimkan tugas ke Pusat Operasi, Anda dapat melakukan pengisian ulang data untuk membuat dan menjalankan instans tugas historis secara batch untuk rentang tanggal tertentu guna menyelesaikan perbaikan data, pengisian ulang, atau analisis retrospektif.

• Tanggal Bisnis: Tanggal bisnis yang dipilih untuk pengisian ulang data konsisten dengan hasil penggantian $bizdate. Jika parameter penjadwalan menggunakan format kustom ${...}, garis dasarnya adalah tanggal yang dipilih, ditransformasi oleh ekspresi waktu yang ditentukan.

• Waktu Penjadwalan: Saat Anda melakukan pengisian ulang data, hasil penggantian untuk $cyctime adalah tanggal bisnis yang dipilih + 1 hari. Misalnya, jika tanggal bisnis yang dipilih untuk pengisian ulang data adalah 20250315, nilai untuk parameter $cyctime akan menjadi 20250316000000. Jika parameter penjadwalan menggunakan format $[...], garis dasarnya adalah tanggal bisnis yang dipilih + 1 hari, ditransformasi oleh ekspresi waktu yang ditentukan.

Hubungan antara parameter penjadwalan, tanggal bisnis, waktu penjadwalan, dan waktu eksekusi aktual

Tentang waktu daylight saving

DataWorks memastikan bahwa tugas berjalan dengan benar pada hari ketika waktu daylight saving (DST) dimulai dan berakhir. Untuk detail tentang cara produk menangani transisi DST, lihat Skenario: Dampak transisi waktu daylight saving pada eksekusi tugas terjadwal. Jika Anda berada di wilayah yang mengamati DST, tinjau dokumen ini untuk menghindari kebingungan selama periode transisi.