Bagaimana cara menggunakan fungsionalitas kerangka waktu ganda/multi-timeframe (MTF)?

Fungsionalitas MTF adalah fitur yang memungkinkan anda untuk mengubah kerangka waktu indikator apa pun hanya dengan dua klik pada Input, dengan menggunakan dropdown Kerangka Waktu.

Pengkode Pine dapat menggunakan parameter kerangka waktu yang sama dengan yang kami gunakan pada indikator bawaan kami di dalam skripnya. Cukup dengan menambahkannya kedalam pernyataan deklarasi indikator skripnya, para pengkode kini memiliki cara mudah untuk menambahkan fungsionalitas MTF ke dalam skripnya dan memungkinkan penggunanya untuk menentukan kerangka waktu yang mereka inginkan untuk menjalankan indikatornya. 

Menggunakan parameter kerangka waktu akan meletakkan sebuah bidang input Kerangka Waktu secara otomatis pada Input skrip anda. Nilai bawaan parameter ini dapat berupa string kerangka waktu mana pun yang valid. Meski demikian, jika tidak disertakan dalam pilihan yang tersedia pada menu dropdownnya, Sama seperti simbol akan muncul sebagai nilai bawaan dalam bidangnya. Gunakan string kosong ("") untuk mewakili kerangka waktu yang ada pada chart.

Katakan, sebagai contohnya, bahwa anda ingin menggunakan sebuah chart dengan kerangka waktu 5m, namun ingin menampilkan Moving Average berdasarkan resolusi 1D. Sebelumnya, anda hanya dapat melakukannya dengan menggunakan fungsi request.security:

//@version=5
indicator(title="Moving Average", shorttitle="MA with security", overlay=true)
len = input.int(9, minval=1, title="Length")
src = input.source(close, title="Source")
out = ta.sma(src, len)
tf = input.timeframe(title="Timeframe", defval="1D")
s1 = request.security(syminfo.tickerid, tf, out, gaps=barmerge.gaps_on)
plot(s1, color=color.red)

Namun sekarang, anda hanya perlu menambahkan timeframe="D" ke panggilan indikator anda:

//@version=5
indicator(title="Moving Average", shorttitle="MA with timeframe", overlay=true, timeframe="D", timeframe_gaps=true)
len = input.int(9, minval=1, title="Length")
src = input.source(close, title="Source")
offset = input.int(title="Offset", defval=0, minval=-500, maxval=500)
out = ta.sma(src, len)
plot(out, color=color.blue, title="MA", offset=offset)

Parameter kerangka waktu yang baru ini membuka jalan untuk menambahkan fungsionalitas MTF secara mudah ke sebuah skrip yang relatif sederhana. Penambahan timeframe_gaps=true bersifat opsional dan pada prinsipnya mirip dengan parameter `gaps` dalam fungsi `request.security()`. Skrip Pine yang lebih kompleks masih memerlukan request.security untuk mengimplementasikan perhitungan lanjutan menggunakan informasi kerangka waktu yang lebih tinggi.

Harap diingat bahwa nilai dari variabel timeframe.* akan mewakili kerangka waktu dari skrip yang sedang berjalan saat ini sebagaimana yang telah ditentukan oleh nilai dari bidang Kerangka Waktu pada input skrip, tanpa memperhatikan kerangka waktu chartnya. Juga diingat bahwa, dikarenakan kerangka waktu yang lebih tinggi mengandung nilai-nilai yang memiliki gap saat parameter kerangka waktu digunakan pada sebuah skrip (kecuali timeframe_gaps disetel ke false), variabel timeframe.* juga akan mengandung nilai n/a antar transisi waktunya. Perilaku seperti ini wajar terjadi. Anda dapat mempelajari lebih lanjut mengenai hal ini pada Pusat Bantuan kami.