MultiCharts编程-PowerLanguage-Data information/General数据信息/常规

第7章 Data information/General数据信息/常规

本章对图表的K线（或Bar）的日期时间、K线的状态、周期数值和类型、开高低收价格、涨跌量和成交量的取值关键字一一做了解说。另外，对一个商品的基本特性取值也提供了相应的关键字，比如整点价值：BigPointValue等。基本特性均可在QuoteManager中设置。

Ago
说明	与Bar，Bars联合使用。Bar前加数值表达式，表示从当根Bar到引用Bar的回溯数量。也可以用方括号括起一个数值表达式来指定引用Bar回溯的数量。
语法	N Bars Ago    或：    [N]
参数	N——数值表达式，用来指定回溯的Bar数量。
范例	用前一根Bar的收盘价画线：    Plot1(Close Of 1 Bar Ago, "Previous Bar's close");    用前第二根Bar的收盘价画线：    Plot1(Close[2], "Close 2 Bars ago");

Bar/Bars
说明	与This，Next或Ago联合使用，引用指定的Bar。
语法	Bar
范例	Close Of 1 Bar Ago 返回值为前一根Bar的收盘价。    以当根K线的收盘价做多开仓：    Buy This Bar On Close;    在下根K线以开盘价做多开仓：    Buy Next Bar On Open;

BarInterval
说明	返回一个数值，表示脚本所在的图表上的数据周期数值。    根据图表周期，返回Ticks，合约(Contracts)，点(Points)，变动(Changes)， 秒(Seconds)，分(Minutes)，时(Hours)，日(Days)，周(Weeks)，月(Months)，季(Quarters)，或年(Years)的设定数值。比如5秒和5tick的图表，BarInterval返回值都为5。
语法	BarInterval
范例	求脚本所在图表数据周期数值（Bar间距）并将值赋给变量Value1：    Value1=BarInterval;

BarStatus
说明	返回一个数值，表示指定的数据中当前Bar的最近一个tick的状态。BarStatus值为0表示最近tick是当前Bar的开盘tick，值为1表示最近tick是当前Bar内的一个tick，值为2表示最近tick是当前Bar的收盘tick 。
语法	BarStatus(DataNum)
参数	DataNum——数值表达式，用来表明指定的数据。    如果参数没有指定，则返回当前数据的值。
范例	如果数据1中，最近一tick是当根Bar的收盘tick，则BarStatus(1) 返回值为2。

BarType/DataCompression
说明	返回一个数值，表明脚本所在数据的周期类型。
语法	Bartype    不同的周期类型对应的Bartype值为：      0  — Ticks &合约 (Ticks &  Contracts)      1  — 日内(秒Seconds, 分Minutes, & 时Hours)      2  — 日Days      3  — 周Weeks      4  — 月，季，年(Months,  Quarters, & Years)      5  — 点&变动(Points & Changes)
范例	取数据的周期类型值，赋给变量Value1：    Value1=BarType;

BarType_ex
说明	Bartype的延伸版本，返回更具体的数据周期类型。    返回值表明脚本所在数据的详细周期类型。
语法	BarType_ex    不同的周期类型对应返回值为：      1  — Ticks      2  — 分Minutes      3  — 时Hours      4  — 日Days      5  — 周Weeks      6  — 月Months      7  — 年Years      8  — Volume      9  — 秒Seconds       10 — 季Quarters       11 — 点Points       12 — 变动Change       13 — Points (Original)       14 — OX图Point & Figure       15 — 卡吉图Kagi       16 — 砖型图Renko       17 — 新价线Line Break       18 — Heikin Ashi
范例	取数据的详细周期类型，赋给变量Value1：    Value1=BarType_ex;

BigPointValue
说明	返回脚本所在图表商品的整点价值。（QuoteManager中的设置）
语法	BigPointValue
注意	BigPointValue=PointValue*PriceScale      整点价值=价格精度的价值*价格精度的倒数
范例	BigPointValue 股指的整点价值为300元。    BigPointValue 白糖（CZCE）的整点价值为10元。

BoxSize
说明	返回指标或信号所在基于价格单位的图表中价格单位的设定值。    在图表中的设置商品-》设置-》图表类型可以设置单位大小的值。
语法	Boxsize
参数	图表类型         返回值         OX图（点数图）         单位大小（纵轴价格单位）         Point图（无此类型）         点数值         砖形图（Renko）         单位大小
范例	如果砖形图的单位大小设定为3，则Boxsize返回值为3。    如果图表类型为标准或卡吉图，则Boxsize返回值为0。

Close/C
说明	返回收盘价。
语法	Close或C
范例	用当前K线的收盘价画：    Plot1(Close,"Close");      用前一根K线的收盘价画线：    Plot1(Close Of 1 Bar Ago,  "Previous Bar's close");    用前第二根K线的收盘价画线：    Plot1(Close[2], "Close 2 Bars ago");

Category
说明	返回脚本所在图表的金融产品类型。
语法	Category    不同的金融产品对应数值为：      0  — Future      1  — Future Option      2  — Stock      3  — Stock Option      4  — Index      5  — Currency Option      6  — Mutual Fund      7  — Money Market Fund      8  — Index Option      9  — Cash       10 — Bond       11 — Spread       12 — Forex       14 — Composite
范例	将脚本所在图表的产品类型对应值赋给变量Value1：    Value1=Category;

CurrentBar
说明	数据在设定的“指标运算参考的最大Bar数量”之后开始给每一根Bar编号，之前设定的参考Bar不编号。例如，指标运算参考的最大Bar数量设为20，则以第21根BAR 开始，从1顺序编号。
语法	CurrentBar
范例	CurrentBar 返回当前Bar的编号。

Date/D
说明	返回Bar的日期值。日期格式为YYYMMdd，YYY表示年（从1900开始的年数），MM表示月，dd表示日。
语法	Date或D
范例	如果日期为2007年10月30日，Date返回值为1071030。    如果日期为1999年4月2日，Date返回值为 990402。

DailyLimit
说明	为了兼容性保留。

Data
说明	跨周期数据图表中指定子图数据。跨周期图表中，每个图表都有唯一的编号。
语法	DataN 或 Data(N)
参数	N——数据编号。    (N)——数值表达式，指定子图编号。
范例	High Of Data2  返回data2的一个Bar的最高价。    High Of Data(2) 返回data2的一个Bar的最高价。

Day/Days
说明	为了与旧版本兼容保留，替代Bar。

DownTicks
说明	图表设置成交量基于成交笔数，则DownTicks返回每根Bar的下跌笔数。    图表设置成交量基于交易量，则DownTicks返回每根Bar的下跌股数（下跌手数）。    当前tick的价格低于前一tick的价格时，则当前tick的成交笔数即为下跌笔数。下跌股数为下跌笔数的成交量，即下跌量。    图表设置成交量基于成交笔数时：    — 1-tick图表中，当前tick的DownTicks返回值为1。    — 多tick，量，时间周期的图表中，当前Bar的DownTicks返回值为当前Bar的下跌笔数。    图表设置成交量基于交易量时：    — 1-tick图表中，当前tick的DownTicks返回值为当前tick的下跌股数。    — 多tick，量，时间周期的图表中，当前Bar的DownTicks返回值为当前Bar的下跌股数。    注意：许多历史数据源只提供有限的历史成交量和成交笔数的数据，实时存储数据可以确保成交量和成交笔数数据的有效性。
语法	Downticks
范例	画出当前Bar的下跌笔数（图表设置成交量基于成交笔数）：    Plot1(DownTicks,"Down  Ticks");    画出当前Bar的下跌股数（图表设置成交量基于交易量）：    Plot1(DownTicks,"Down  Volume");

ExpirationDate
说明	返回值为脚本所在图表中商品的到期日（QM中设置）。日期格式为YYYMMdd，YYY表示年（从1900开始的年数），MM表示月，dd表示日。例如日期为2007年10月30日，则返回值为1071030，日期为1999年4月2日，返回值为 990402。
语法	ExpirationDate    （到期日只能用在期货和期权。）
范例	如果到期日为2008年10月30日，则ExpirationDate返回值为1081030。    如果到期日为1990年4月2日，则ExpirationDate返回值为9900402。

GetExchangeName
说明	返回字符串表达式，包含图表中的商品的交易所名称。
语法	GetExchangeName
范例	图表为股指期货数据，GetExchangeName返回”CFFEX”。    图表为E-mini S&P 500 ，GetExchangeName返回”CME”。

GetSymbolName
说明	返回字符串表达式，包含图表中商品名称。
语法	GetSymbolName
范例	图表商品为股指期货主力合约，GetSymbolName返回值：    “ICE.CFFEX.IF.HOT”

High/H
说明	返回最高价。
语法	High
范例	用当前K线的最高价画线：    Plot1(High,"High");      用前一根K线的最高价画线：    Plot1(High Of 1 Bar Ago,"Previous  Bar's high");    用前第二根K线的最高价画线：    Plot1(High[2],"High 2 Bars ago");

Low/L
说明	返回最低价。
语法	Low
范例	用当前K线的最低价画线：    Plot1(Low,"Low");      用前一根K线的最低价画线：    Plot1(Low Of 1 Bar Ago,"Previous  Bar's low");    用前第二根K线的最低价画线：    Plot1(Low[2],"Low 2 Bars ago");

Open/O
说明	返回开盘价。
语法	Open
范例	以当前K线的开盘价画线：    Plot1(Open,"Open");      以前一根K线的开盘价画线：    Plot1(Open Of 1 Bar Ago,  "Previous Bar's open");    以前第二根K线的开盘价画线：    Plot1(Open[2],"Open 2 Bars ago");

Openint/I
说明	基于tick和量周期的图表，openint值为当前Bar的未平仓量。    日线以下的时间周期图表：    —图表设置成交量基于成交笔数，则openint返回值为下跌笔数。    —图表设置成交量基于交易量，则openint返回值为下跌股数（下跌手数）。    Openint支持日线和以上时间周期的图表。
语法	Openint
范例	以当前Bar的openint 值画线：    Plot1(OpenInt,"Open  interest");    以前一根K线的openint值画线：    Plot1(OpenInt Of 1 Bar Ago,"Previous  Bar's open interest");    以前第二根openint值画线：    Plot1(OpenInt[2],"Open interest 2 Bars ago");

IntervalType
说明	返回一个数值，表明图表数据的周期。
语法	IntervalType    不同的数据周期对应数值：    0 — Ticks (Ticks & Contracts)      1  — 日内 (Seconds, Minutes,  & Hours)      2  — 日Days      3  — 周Weeks      4  — 月，季，年(Months,  Quarters, Years)      5  — 点，变动(Points, Changes)      0  – 4 — OX图Point & Figure      0  – 4 —卡吉图Kagi      0  – 4 — 新价线Line Break      0  — 砖形图Renko
范例	取图表数据周期对应数值，并赋给变量Value1：    Value1 = IntervalType;

IntervalType_ex
说明	IntervalType的延伸版本。    更具体的表明图表的数据周期。返回一个数值，表明图表数据的周期。
语法	IntervalType_ex    不同数据周期对应数值：    1 — Ticks      2  — 分Minutes      3  — 时Hours      4  — 日Days      5  — 周Weeks      6  — 月Months      7  — 年Years      8  — Volume      9  — 秒Seconds       10 — 季Quarters       11 — 点Points       12 — 变动Change       13 — Points (Original)    1 - 7, 9, 10 — OX图Point &  Figure      1  - 7, 9, 10 — 卡吉图Kagi      1  - 7, 9, 10 — 新价线Line Break      1  — 砖型图Renko
范例	取图表数据周期对应数值，并赋给变量Value1：    Value1 = IntervalType_ex;

MinMove
说明	返回一个数值，表明图表中数据的价格变动的最小单位。（Quote Manager中的设置）    只能设置为整数。
语法	Minmove
范例	股指的Minmove是2 。    白糖的Minmove是1 。    MinMove*PointValue返回当前图表商品的一跳对应的价值。如股指返回60（2*30元）

Next
说明	和Bar联合使用表示下一根Bar。
语法	Next Bar
范例	在下一根Bar的开盘以市价买入开仓：    Buy Next Bar At Market;

Point/Points
说明	返回一个十进位数值，等于价格精度（QM设定）。
语法	Point
注意	Point=1/Pricescale
范例	股指的 1 Point为0.1    白糖的 1 Point为1    MinMove * 1 Point 返回当前图表商品的一跳。如股指返回0.2

PointValue
说明	返回一个数值，表明1价格精度的价值。
语法	Pointvalue
注意	Pointvalue=Bigpointvalue/Pricescale    价格精度价值=整点价值/价格精度的倒数
范例	股指的Pointvalue为30    白糖的Pointvalue为10

PriceScale
说明	返回一个数值，代表价格精度的倒数。
语法	Pricescale
注意	Pricescale=Bigpointvalue/Pointvalue    价格精度倒数=整点价值/价格精度价值
范例	股指的Pricescale 为10    白糖的Pricescale为1

RevSize
说明	返回OX图的反转设定值，卡吉图的反转设定值，或新价线图的反转设定值。    可以在设置商品-》设置-》图表类型中设定此值。
语法	Revsize
范例	如果OX图的反转设定为3，则Revsize返回值为3    如果卡吉图的反转设定为4%，则Revsize返回值为4%    如果新价线图的反转设定为5，则Revsize返回值为5

SessionLastBar
说明	返回逻辑值，表明当前Bar是否为时段结束前的最后一根Bar。如果当前Bar是交易时段的最后一根Bar则返回值为True，否则返回值为False。
语法	SessionLastBar
范例	判断当前Bar是否为交易时段的最后一根Bar，将结果赋值给变量LastBar:    Variable:LastBar(False);      LastBar=SessionLastBar;

Time/T
说明	返回一个数值，表示当前Bar的收盘时间。时间格式为HHmm，24小时制，如1300=1:00pm
语法	Time
范例	10:15 AM时Time返回值1015      3:45 PM 时Time返回值 1545

Time_s
说明	返回一个数值，表示当前Bar的收盘时间，时间包含秒。时间格式为HHmmss，24小时制，130000=1:00:00pm
语法	Time_s
范例	10:15:25 AM 时Time_s 返回值为 101525      3:45:00 PM 时 Time_s 返回值为 154500

This
说明	和Bar联合使用表示当根Bar。
语法	This Bar
范例	在当根Bar的收盘价买入开仓：    Buy This Bar On Close;

Ticks
说明	图表设置成交量基于成交笔数，则Ticks返回每根Bar的成交笔数。    图表设置成交量基于交易量，则Ticks返回每根Bar的成交股数（成交手数）。    图表设置成交量基于成交笔数时：    — 1-tick图表中，当前tick的Ticks返回值为1。    — 多tick、量、时间周期的图表中，当前Bar的Ticks返回值为当前Bar的成交笔数。    图表设置成交量基于交易量时：    — 1-tick图表中，当前tick的Ticks返回值为当前tick的成交股数。    — 多tick，量，时间周期的图表中，当前Bar的Ticks返回值为当前Bar的成交股数。    注意：许多历史数据源只提供有限的历史成交量和成交笔数的数据，实时存储数据可以确保成交量和成交笔数数据的有效性。
语法	Ticks
范例	画出当前Bar的成交笔数（图表设置成交量基于成交笔数）：    Plot1(Ticks,"Ticks");      画出当前Bar的成交股数（图表设置成交量基于交易量）：    Plot1(Ticks,"Volume");

Today
说明	为与旧版本兼容保留，用This Bar替代。

UpTicks
说明	如果图表设置成交量基于成交笔数，则UpTicks返回值为上涨笔数。    如果图表设置成交量基于交易量，则UpTicks返回值为上涨股数。    当前tick的价格高于前根tick的价格时，则当前tick的成交笔数即为上涨笔数。上涨股数为上涨笔数的成交量，即上涨量。    图表设置成交量基于成交笔数时：    — 1-tick图表中，当前tick的UpTicks返回值为1。    — 多tick，量，时间周期的图表中，当前Bar的UpTicks返回值为当前Bar的上涨笔数。    图表设置成交量基于交易量时：    — 1-tick图表中，当前tick的UpTicks返回值为当前tick的上涨股数。    — 多tick，量，时间周期的图表中，当前Bar的UpTicks返回值为当前Bar的上涨股数。    注意：许多历史数据源只提供有限的历史成交量和成交笔数的数据，实时存储数据可以确保成交量和成交笔数数据的有效性。
语法	Upticks
范例	画出当前Bar的上涨笔数（图表设置成交量基于成交笔数）：    Plot1(UpTicks,"Up  Ticks");    画出当前Bar的上涨股数（图表设置成交量基于成交股数）：    Plot1(UpTicks,"Up  Volume");

Volume/V
说明	返回当前Bar的成交量。    对于Tick周期，基于量的周期，日以内时间周期的图表：    —图表设置成交量基于交易量，则volume值为当前Bar的上涨股数。    —图表设置成交量基于成交笔数，则volume值为当前Bar的上涨笔数。    对于日线及日以上时间周期的图表：    —图表设置成交量基于交易量，则volume值为成交股数。    —图表设置成交量基于成交笔数，则volume值为成交笔数。    注意：许多数据源只提供有限的历史成交量和成交笔数的数据，实时存储数据可以确保成交量和成交笔数数据的有效性。
语法	Volume
范例	以当前Bar的volume值画线：    Plot1(Volume,"Volume");      以前一根Bar的volume值画线：    Plot1(Volume Of 1 Bar Ago,"Previous Bar's volume");    以前第二根Bar的volume值画线：    Plot1(Volume[2],"Volume 2 Bars ago");

Yesterday
说明	为与旧版本兼容保留。