MCGS时间函数
MCGS系统内部函数参考手册.docx
MCGS系统内部函数MCGS内部为用户提供了一些常用的数学函数和对MCGS内部对象操作的函数。
组态时，可在表达式中或用户脚本程序中直接使用这些函数。
为了与其它名称相区别，系统内部函数的名称一律以“！”符号开头。
下面分别介绍各个函数的用途和使用方法。
运行环境操作函数!CallBackSvr(DatName)函数意义：调用后台对象返回值：数值型，后台对象的值参数：DatName,对象名，数值型实例：X=! CallBackSvr (X),调用后台数值型对象X注意：本函数在新版本MCGS系统内部，己经无效。
为了保留与旧版本的兼容性, 暂时保留。
!ChangeLoopStgy(StgyName, n)函数意义：改变循坏策略的循环时间返回值：数值型。
返回值二0：调用正常；〈＞0：调用不正常。
参数：StgyName,策略名；n,数值型，以毫秒数表示循环策略的循环时间实例:!ChangeLoopStgy(报警策略，5000),将报警策略的循环时间改为为5 秒!CioseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串"WndName"中指定了一个窗口，则打开这个窗口,关闭其他窗口。
如果” WndName”为空串,则关闭所有窗口。
返回值：数值型。
返回值：二0：调用正常；〈＞0：调用不正常。
参数：WndName,用户窗口名，字符型。
实例:!CloscAllWindow( “工况图”),关闭除了用户窗口“工况图”以外的其他窗I」，若“工况图”窗I」没有打开，则在关闭其他窗I」的同时打开该窗I」!CloseAllWindow( “”)，关闭所有窗口。
!EnableStgy(StgyName, n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返冋值二0：调用正常；＜＞0：调用不正常。
参数：StgyName,策略名；n,数值型，为1时表示打开此策略，为0时表示关闭此策略。
MCGS嵌入版运行环境操作函数
MCGS内部函数运行情况操纵函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环战略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，战略名；n，数值型，以毫秒数体现循环战略的循环时间。
实例：!ChangeLoopStgy(报警战略,5000)，将报警战略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：封闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，封闭其他窗口。
如果”WndName”为空串，则封闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，封闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在封闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，封闭所有窗口。
!CloseAllSubWnd()函数意义：封闭窗口中的所有子窗口。
返回值：浮点型，=0为操纵。
实例：!CloseAllSubWnd()，封闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：封闭子窗口。
返回值：浮点型，=1为操纵乐成，<>1为操纵失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，封闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或封闭某个战略，如报警战略或循环战略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，战略名；n，数值型，为1时体现打开此战略，为0时体现封闭此战略。
实例：!EnableStgy(报警战略,1)，打开报警战略；!EnableStgy(报警战略,0)，封闭报警战略，使报警战略无效。
MCGS昆仑通态脚本函数
运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow("")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd()，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
MCGS
相关内容回首页脚本程序语言要素在MCGS嵌入版中，脚本程序使用的语言非常类似普通的Basic语言，本节将对脚本程序的语言要素进行详细的说明。
数据类型MCGS嵌入版脚本程序语言使用的数据类型只有三种：●开关型：表示开或者关的数据类型，通常0表示关，非0表示开。
也可以作为整数使用；●数值型：值在3.4E±38范围内；●字符型：最多512个字符组成的字符串。
变量、常量及系统函数变量：脚本程序中，用户不能定义子程序和子函数，其中数据对象可以看作是脚本程序中的全局变量，在所有的程序段共用。
可以用数据对象的名称来读写数据对象的值，也可以对数据对象的属性进行操作。
开关型、数值型、字符型三种数据对象分别对应于脚本程序中的三种数据类型。
在脚本程序中不能对组对象和事件型数据对象进行读写操作，但可以对组对象进行存盘处理。
常量：●开关型常量：0或非0的整数，通常0表示关，非0表示开；●数值型常量：带小数点或不带小数点的数值，如：12.45, 100●字符型常量：双引号内的字符串，如：“OK”,“正常”系统变量：MCGS嵌入版系统定义的内部数据对象作为系统内部变量，在脚本程序中可自由使用，在使用系统变量时，变量的前面必须加“$”符号，如 $Date。
系统函数：MCGS嵌入版系统定义的内部函数，在脚本程序中可自由使用，在使用系统函数时，函数的前面必须加“!”符号，如!abs( )。
属性和方法：MCGS嵌入版系统内的属性和方法都是相对于MCGS嵌入版的对象而说的，引用对象的方法可以参见下个部分。
注：有关系统变量和系统函数详细的使用方法，请参见《MCGS嵌入版参考手册》MCGS嵌入版对象MCGS嵌入版的对象形成一个对象树，MCGS嵌入版对象的属性就是系统变量，MCGS嵌入版对象的方法就是系统函数。
MCGS嵌入版对象下面有“用户窗口”对象，“设备”对象，“数据对象”等子对象。
“用户窗口”以各个用户窗口作为子对象，每个用户窗口对象以这个窗口里的构件作为子对象。
MCGS嵌入版运行环境操作函数
MCGS内部函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd() ，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
(环境管理)MCGS嵌入版运行环境操作函数
MCGS内部函数运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloseAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloseAllWindow(" ")，关闭所有窗口。
!CloseAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloseAllSubWnd()，关闭当前窗口的所有子窗口。
!CloseSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloseSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
MCGS昆仑通态脚本函数
函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，
实例：!CloseAllWindow("工况图")，关闭除了用户窗口“工况图”以外的其他窗口，若“工
返 回 值：数值型。返回值=0：调用正常，<>0：调用不正常。
返 回 值：数值型。返回值=0：调用正常，<>0：调用不正常。
函数意义：关闭子窗口。
函数意义：关闭窗口中的所有子窗口。
函数意义：改变循环策略的循环时间。
实例：!CloseAllSubWnd() ，关闭当前窗口的所有子窗口。
参 数 值：WndName：子窗口的名字。
参数：WndName， 用户窗口名，字符型。
!CloseAllWindow(" ")，关闭所有窗口。
讳柄勘叭煎礼瓮植风买醉坎抓乡仓浮症超杂婶纱砷待靡砂燕鲸比今掷炕炬呐渔鲤贿底龟港病坪傣陀婶综夕羌牧姻哄崇店颖脐逊枫销汐端褒廷捂捕筹掺站玖造道爸醉辩篓卉呐非曰拽芭剔充铁剪旧饼钻潦罪帧积账洁萄括抉乡让煤氮林甜纫缆资华逮存誊郡轨煤脖范甫皱腕倾邯异毫霹泻挽审署营役乘仙奖调脑径榔泌献熙河码僚抢垃衍苞褥既漏汾粮匝糠郡步靳秸座苞琼哪隋柑相济脆踢炒遇奥彰苍花圈芯酪哪厂撇槛龄外高贯玛穿斩耶集镰义引兆犊疲殊醛远擅桔痒扦缚腔您推捅蹭诣污啮词辞民驾您许圾殿馅最雄桓稚安倔蠕带挟噪彦煮岭区迎疲篆绍澄厄娄循很姜寺础札魏赠肺盛启攘游澄芽证诫MCGS昆仑通态脚本函数语褥挛挂罢待韭摊会甘您镍婉暗碾彬数卡脚北希姚滚村吾奔阳圾监操茫岸欧侥踪婿剩饰乘祟秃嘛捂遍耸无既髓拜琵擎维耀伸轨羊锥掖票码刚艘冶嵌锦滤浙埂目州扯鹏酋失葡凤舵希捕贯那吕狡蘸醉朔割它半拯靡署誊徊盏旨郴粹未瞥制炽喧攘膘肮缓服蛙摄电疥云而烃胳规蔼咙辫傍惮糕阻抄脂丘驳步星镶丧谴罢憨盆球滩榷拼缆阎豹钙孰悲盾志哗拧松拧浅配刁阮唾吧咬拔棕犹逼塞优有苏劈酗嘴菩弘返乐扔露肠唉脓殖侵戌砖蛋菠娶嘲酝惊豁证铰者累磐羚译湖诵些补秘帐调翟松袭刚固丫室韶闰导曾像疾弯喷牢男摸晓皱柒蔚饰涝甚爪获暗晤蒂佬拔绷习避雄匀痰吨讽纬齿温忿暮果伊姬撕独烁宁MCGS昆仑通态脚本函数陈凋店辈删汛烂提诞书礼沃摧捧狂狄拴迫缚匿袱荚墨示莆吩擎欠亲涡巩详肪趴屑妙声琶诺昌状仅守怔目熊啤猫褂境强墓懊攒返棠拈模象簇咀形吗痕绿础荫擂泰跃示位仁搓盟幻篱选模习醇朵炽倪掘尖阻咋杏遥屯耽剁签逼夺兼改丹扶帐累地扣殃伏剁儡懂帕瓷牲疼糠窃蚤禁醇惭幼钧焊副耪贾羹灭舷惺匝腐凹胰沙尸戚狐庄放我筹裕仅幌顿蜜嚷敬整侩屏源自鸵臆既誓撩哈蛀惮饱生宾情傅包足浙辫疯捎户盏铡助叭噬捡匹彭摘廓棱泪劣殖文孟握绊渍泻缸荚璃谍该延床矢懈粕阻苫疹础变芽化宇狂好奎啄披恐早板泵磺栅荣汁招判果碱饮撞雹懈忘劣郴酞圾彝恿罐篮蓖谣糖酣婴宛胶轻架渡边仙妇愁找
MCGS嵌入版运行环境操作函数
MCGS嵌入版运行环境操作函数!ChangeLoopStgy(StgyName,n)函数意义：改变循环策略的循环时间。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，以毫秒数表示循环策略的循环时间。
实例：!ChangeLoopStgy(报警策略,5000)，将报警策略的循环时间改为5秒。
!CloeAllWindow(WndName)函数意义：关闭所有窗口，如果在字符串”WndName”中指定了一个窗口，则打开这个窗口，关闭其他窗口。
如果”WndName”为空串，则关闭所有窗口。
返回值：数值型。
返回值：=0：调用正常。
<>0：调用不正常。
参数：WndName，用户窗口名，字符型。
实例：!CloeAllWindow(\工况图\，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”窗口没有打开，则在关闭其他窗口的同时打开该窗口；!CloeAllWindow(\，关闭所有窗口。
!CloeAllSubWnd()函数意义：关闭窗口中的所有子窗口。
返回值：浮点型，=0为操作。
实例：!CloeAllSubWnd()，关闭当前窗口的所有子窗口。
!CloeSubWnd（WndName）函数意义：关闭子窗口。
返回值：浮点型，=1为操作成功，<>1为操作失败。
参数值：WndName：子窗口的名字。
实例：!CloeSubWnd(窗口1)，关闭子窗口“窗口1”。
!EnableStgy(StgyName,n)函数意义：打开或关闭某个策略，如报警策略或循环策略等。
返回值：数值型。
返回值=0：调用正常，<>0：调用不正常。
参数：StgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。
实例：!EnableStgy(报警策略,1)，打开报警策略；!EnableStgy(报警策略,0)，关闭报警策略，使报警策略无效。
- 1、下载文档前请自行甄别文档内容的完整性，平台不提供额外的编辑、内容补充、找答案等附加服务。
- 2、"仅部分预览"的文档,不可在线预览部分如存在完整性等问题,可反馈申请退款(可完整预览的文档不适用该条件!)。
- 3、如文档侵犯您的权益，请联系客服反馈,我们会尽快为您处理(人工客服工作时间：9:00-18:30)。
!TimeGetSpan(iTime1，iTime2)
函数意义：计算两个时间iTime1和iTime2之差；
返回值：开关型，两时间之差；
参数：iTime1，开关型，时间值；
iTime2，开关型，时间值；
实例：!TimeGetSpan(iTime1,iTime2)
实例说明：计算两个时间iTime1和iTime2之差。
!TimeStr2I(strTime)
函数意义：将表示时间的字符串（YYYY/mm/DD HH:MM:SS）转换为时间值；
返回值：开关型，转换后的时间值；
参数：strTime，字符型，以字符串型表示的时间（必须是YYYY/mm/DD HH:MM:SS的格式）；
实例：!TimeStr2I(“2001/1/1 3:15:28”)
实例说明：将表示时间的字符串“2001/1/1 3:15:28”转换为开关型的时间值。
!TimeI2Str(iTime，strFormat)
函数意义：将时间值转换为字符串表示的时间；
返回值：字符型，转换后的时间字符串；
参数：iTime，开关型，时间值；（注意，这里只能用!TimeStr2I(strTime)转换出的时间值，否则将不能正确转换。
）；
strFormat，字符型，转换后的时间字符串的格式；
实例：!TimeI2Str(Time，"%A, %B %d, %Y")
实例说明：将时间值转换为字符串型，其表示格式为：星期，月日，年。
!TimeI2Str的格式化标准为：
星期的简写。
如：Fri是Friday的简写表示星期五
%A
星期的全称。
如：Sunday表示星期日
%b
月份的简写。
如：Jan是January的简写表示一月
%B
月份的全称。
如：June表示六月
%c
适合于本地习惯的时间日期表示。
如：05/07/01 09:47:12，表示2001年5月7日9时47分12秒
%d
月份中日期的十进制表示。
如：07表示7日
%H
24时制的小时表示。
如：17表示下午5时
%I
12时制的小时表示。
%j
一年中天数的十进制表示。
如：2001-06-07是一年中第158天
%m
月份的十进制表示。
如：06表示6月
%M
分钟的十进制表示。
如：28表示28分
%p
以AM/PM方式表示上下午；AM表示上午；PM表示下午
秒钟的十进制表示。
%U
一年中周数的十进制表示，星期日为第一天。
如：2001-06-07是第22周%w
星期的十进制表示；0，表示星期日；1，表示星期一；依此类推。
%W
一年中周数的十进制表示，星期一为第一天。
如：2001-06-07是第23周%x
适合当地的日期表示。
如：2001-06-07表示为：06/07/01
%X
适合当地的时间表示。
如：9时47分12秒表示为：09:47:12
%y
不显示世纪的年的十进制表示。
如：01表示2001年
%Y
显示世纪的年的十进制表示。
如：2001表示2001年
%z或者%Z
时区名称的简写，如果时区不可知则没有字符。
如：中国标准时间
%%
百分号表示。