內建函數 - 一般函數


函數名稱 函數中文名稱 語法
BarAdjusted 目前執行的K棒是否為還原頻率 回傳執行腳本資料頻率是否為還原頻率。回傳布林值。
若為還原頻率,則回傳「True」
若不為還原頻率,則回傳「False」
BarFreq 取得目前執行的K棒的頻率 傳回執行腳本資料頻率的單位。
執行頻率 = BarFreq
回傳以下字串: 分鐘線:"Min",
日線:"D",周線:"W", 月線:"M",
還原日線:"AD",還原周線:"AW", 還原月線:"AM",
季線:"Q", 半年線:"H",年線:"Y"
BarInterval 分鐘區間 傳回執行腳本資料的分鐘頻率間隔
分鐘區間 = BarInterval
如果頻率是分鐘資料,則回傳分鐘的間隔,例如30分鐘線的話則回傳30,否則一律回傳1
CallFunction 呼叫函數 呼叫函數執行
回傳數值=CallFunction(函數名稱,參數一,參數二,...)
傳入一個以上參數:
- 第一個參數是函數名稱的字串。
- 第二個參數是被呼叫函數的第一個參數。
- 第三個參數是被呼叫函數的第二個參數。依此類推。
CurrentBar 目前K棒的編號 傳回K棒目前的編號。
K棒編號 = CurrentBar
DataAlign 資料對位 設定資料對位方式
DataAlign(欲設定的資料對位方式)
如果是絕對對位的話,資料對位方式為0,如果是遞補對位的話,資料對位方式為1
ExecOffset 取得K棒偏移筆數 回傳目前函數執行時偏移的K棒筆數
偏移筆數 = ExecOffset
File 指定Print輸出的檔案位置 與Print指令搭配,用來指定Print輸出檔案的位置
Print(File(檔案路徑), 輸出數值1, 輸出數值2, 輸出數值3)
Print(File(檔案名稱), 輸出數值1, 輸出數值2, 輸出數值3)
GetBackBar 讀取資料引用筆數 回傳目前腳本計算所使用的資料引用筆數
回傳數值= GetBackBar
GetBarBack 讀取資料引用筆數 回傳目前腳本計算所使用的資料引用筆數
回傳數值= GetBarBack
GetBarOffset 取得相對K棒位置 依日期取得相對K棒位置。
回傳數值=GetBarOffset(日期)
回傳數值=GetBarOffset(日期,時間)
傳入二個參數:
- 第一個參數是日期,格式為YYYYMMDD。
- 第二個參數是時間,格式為HHMMSS,第二個參數可以不用傳。
GetFieldStartOffset 判斷欄位初始點 判斷欄位初始點
欄位筆數 = GetFieldStartOffset("欄位名稱")
欄位筆數 = GetFieldStartOffset("欄位名稱", "頻率")
回傳目前最新一筆欄位與此欄位的第一筆資料間的欄位筆數。
如果無此欄位,或是欄位的初始點超過目前bar的位置,則回-1。
※如果不傳頻率的話,則讀取目前執行頻率的對應欄位。
※僅支援「選股」腳本類型。
GetFirstBarDate 讀取第一筆資料的日期 回傳目前腳本計算所使用第一筆資料的日期
回傳日期= GetFirstBarDate
GetInfo 取得執行資訊 用來取得目前腳本的執行環境資訊。
回傳數值=GetInfo(資訊名稱)
傳入一個參數:
- 第一個參數是資訊名稱字串,可以是"Instance"、"IsRealTime"、"IsTimerMode"、"FilterMode"、"TradeMode"、"AT_EnableTrade"、"AT_BID"、"AT_AccType"或"AT_AID"
GetSymbolFieldStartOffset 判斷欄位初始點 判斷欄位初始點
欄位筆數 = GetSymbolFieldStartOffset("ID", "欄位名稱")
欄位筆數 = GetSymbolFieldStartOffset("ID", "欄位名稱","頻率")
回傳目前最新一筆欄位與此欄位的第一筆資料間的欄位筆數。
如果無此欄位,或是欄位的初始點超過目前bar的位置,則回-1。
※如果不傳頻率的話,則讀取目前執行頻率的對應欄位。
※僅支援「選股」腳本類型。
GetTBMode 取得自定指標繪圖模式 取得自定指標的繪圖模式
回傳數值= GetTBMode
GetTotalBar 讀取總額資料 回傳目前腳本計算所使用的資料筆數
回傳數值= GetTotalBar
IsFirstCall 特定執行時機點 回傳目前計算的K棒(currentbar)是否為事件的第一次洗價
傳入事件字串:" "、"Bar"、"Date"、"Realtime"
回傳布林值=IsFirstCall
IsLastBar 判斷是否為最新的K棒 回傳目前計算的K棒(currentbar)是否為最新的K棒
回傳布林值=IsLastBar
IsSessionFirstBar 判斷是否為當日第一根K棒 回傳目前計算的K棒(currentbar)是否為當日第一根K棒
回傳布林值=IsSessionFirstBar
IsSessionLastBar 判斷是否為當日最後一根K棒 回傳目前計算的K棒(currentbar)是否為當日最後一根K棒
回傳布林值=IsSessionLastBar
MaxBarsBack 回傳腳本所設定的最大引用筆數 取得腳本執行時所設定的最大引用筆數
Value1 = MaxBarsBack
NoPlot 清除某個指標序列的數值 清除指定的指標序列目前這根K棒上面的數值
NoPlot(指標繪圖序列編號)
指標繪圖序列編號從1到999
OutputField 設定選股輸出欄位 指定選股的輸出欄位
OutputField(輸出序號, 數值)
OutputField(輸出序號, 數值, 小數位數)
OutputField(輸出序號, 數值, 小數位數, 輸出欄位名稱)
OutputField1(數值)
OutputField1(數值, 小數位數)
OutputField1(數值, 小數位數, 輸出欄位名稱)
Playsound 播放音效 播放指定的音訊檔案
Plot 產生圖形上的繪圖序列 產生指標腳本的繪圖序列語法:
Plot(輸出序號,指標數值)
Plot(輸出序號,指標數值,繪圖序列名稱)
Plot(輸出序號,指標數值,繪圖序列名稱,checkbox:=1)
Plot1(指標數值)
Plot1(指標數值,繪圖序列名稱)
Plot1(指標數值,繪圖序列名稱,checkbox:=1)
PlotFill 產生圖形上的繪圖序列 PlotFill(序列編號, vFrom, vTo);
PlotFill(序列編號, vFrom, vTo, "序列名稱");
PlotK 產生圖形上的繪圖序列 在腳本運算的橫軸位置上畫出K棒。
PlotK(序列編號, vOpen, vHigh, vLow, vClose)
PlotK(序列編號, vOpen, vHigh, vLow, vClose, "序列名稱")
PlotLine 指標趨勢線 繪製直線。
PlotLine(序列編號, x1, y1, x2, y2)
PlotLine(序列編號, x1, y1, x2, y2, "序列名稱")
Print 輸出執行結果 將文字/數值輸出到XSScript編輯器的執行畫面跟檔案內
Print(數值1, 數值2, 數值3, ...)
Print(指定檔案,數值1, 數值2, 數值3, ...) ← 交易腳本必須用此法才能列印到檔案。
※執行選股與執行回測時,Print檔案加總超過 100M 就不會印出。
RaiseRunTimeError 產生錯誤中斷 用來中斷執行中的程式
RaiseRunTimeError(錯誤訊息)
SetAlign 設定資料對位方式 根據欄位屬性,指定腳本執行時的資料對位計算方式
SetAlign("籌碼",資料對位計算方式)
SetAlign("營收財報",資料對位計算方式)
SetBackBar 設定最大引用筆數 腳本執行時,設置指定頻率的最大引用筆數
SetBackBar(最大引用筆數)
SetBackBar(最大引用筆數, "頻率")
如果不傳頻率的話,則指定目前執行頻率的最大引用筆數。
SetBarBack 設定最大引用筆數 腳本執行時,設置指定頻率的最大引用筆數
SetBarBack(最大引用筆數)
SetBarBack(最大引用筆數, "頻率")
如果不傳頻率的話,則指定目前執行頻率的最大引用筆數。
SetBarFreq 指定腳本支援的頻率 指定這個腳本可以支援的頻率(只可使用在選股腳本內)
SetBarFreq(支援頻率1, 支援頻率2, 支援頻率3, ...)
可以傳入多個頻率字串
SetBarMode 設定函數計算方式 指定腳本執行時的函數計算方式
SetBarMode(函數計算方式)
SetFirstBarDate 設定資料開始日期 指定腳本執行時第一筆資料的日期(不支援交易腳本)
SetFirstBarDate(資料開始日期)
SetInputName 設定輸入參數的名稱 設定輸入參數(Input)的顯示名稱
SetInputName(序號, 顯示名稱)
SetInputName1(顯示名稱)
SetOutputName 設定選股輸出欄位標題 指定選股的輸出欄位標題
SetOutputName(序號, 欄位標題)
SetOutputName1(欄位標題)
SetPlotLabel 設定繪圖標記名稱 設定繪圖序列的名稱
SetPlotLabel(繪圖序列編號,繪圖序列名稱)
SetTBMode 設定自定指標繪圖模式 指定自定指標的繪圖模式
SetTBMode(繪圖模式)
SetTotalBar 設定資料讀取筆數 指定腳本執行時的資料讀取筆數
SetTotalBar(資料讀取筆數)
SymbolExchange 目前執行商品的交易所編碼 目前執行商品的交易所編碼
回傳代碼 = SymbolExchange
SymbolType 目前執行腳本的商品類型 回傳目前執行腳本的商品類型
回傳代碼 = SymbolType