MCGS时间函数

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内部函数运行情况操纵函数!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)，封闭报警战略，使报警战略无效。

运行环境操作函数!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嵌入版中，脚本程序使用的语言非常类似普通的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内部函数运行环境操作函数!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嵌入版运行环境操作函数!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)，关闭报警策略，使报警策略无效。

!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日%H24时制的小时表示。

如：17表示下午5时%I12时制的小时表示。