1、組態王命令語言函數速查手冊北京亞控科技發展有限公司1命令語言函數速查手冊“組態王”支持使用內建的復雜函數，其中包括字符串函數、數學函數、系統函數、控件函數、報表函數及其他函數，下面依次介紹各個函數（函數名不區分大小寫，按字母排序）：Abs此函數用于計算變量值的絕對值，使用格式如下：Abs(變量名或數值);返回值：整值或實型值；例如：Abs(14); 返回值為14Abs(-7.5); 返回值為7.5Abs(距離); 返回內存模擬變量“距離”的絕對值。Ack對變量進行報警確認，或對報警組進行報警確認。如果函數參數為變量名稱，則只對該變量進行報警確認；如果函數參數為報警組名稱，則確認所有屬于該報警組

2、及其子報警組的變量。該函數的參數只能是變量名或報警組名，不可以為字符串變量。此函數常用于按鈕命令語言，當發生報警時，用此函數進行報警確認，它將產生確認報警事件。調用格式：Ack(報警組名)； 或 Ack(變量名)；例如：Ack(全廠)； 或 Ack(反應罐液位)；組態王命令語言函數速查手冊北京亞控科技發展有限公司2AckByTagName對變量進行報警確認。函數參數可以是一個字符串變量，也可以是一個表示變量名的字符串。調用格式：AckByTagName("tag_name");參數：tag_name：變量名。例如：AckByTagName ("本站點液位"

3、;);AckByTagName(Varname);其中Varname 為字符串變量。AckByGroupName對報警組進行確認。調用格式：AckByGroupName( "station_name", "group_name" );station_name 為產生報警的IO 服務器名，group_name 為報警組名。函數參數可以是字符串變量，也可以是表示IO 服務器名或報警組名的字符串。例如：AckByGroupName ("PC1","報警組1");AckByGroupName (PCName, GroupN

4、ame);/PCName, GroupName為字符串變量。ActivateApp此函數用于激活正在運行的窗口應用程序，使之變為當前窗口。獲得輸入焦點。該函數也可配合函數SendKeys 的使用。調用形式：ActivateApp(“ExeName”)；參數：ExeName 應用程序的執行文件名例如：組態王命令語言函數速查手冊北京亞控科技發展有限公司3激活Microsoft Word 的正確調用為：ActivateApp("Word.exe")；激活組態王：可使用 ActivateApp("TouchVew.exe")；ActiveXIsVisible此函

5、數用于控制窗體控件隱含。調用形式：ActiveXIsVisible("CtrlName", nMode)；參數：CtrlName 控件名nMode 控制模式。nMode=0 時，控件隱含。例如：實現控件隱含的正確調用為：ActiveXIsVisible(“Ctrl10”, 0)；ArcCos此函數用于計算變量值的反余弦值, 變量值的取值范圍在-1，1之間，否則函數返回值無效。調用格式：ArcCos(變量名或數值);返回值：整值或實型值；例如：ArcCos(1); 此函數返回值為0ArcCos(temp); 此函數返回變量“temp”的反余弦值。ArcSin組態王命令語言函數

6、速查手冊北京亞控科技發展有限公司4此函數用于計算變量值的反正弦值, 變量值的取值范圍在-1，1之間，否則函數返回值無效。調用格式：ArcSin(變量名或數值);返回值：整值或實型值；例如：ArcSin(1); 此函數返回值為90ArcSin(temp); 此函數返回變量“temp”的反正弦值。ArcTan此函數用于計算變量值的反正切值, 使用格式為：ArcTan(變量名或數值);返回值：整值或實型值；例如：ArcTan(1); 此函數返回值為45ArcTan (temp); 此函數返回變量“temp”的反正切值。Average此函數為對指定的組態王報表表格的多個單元格求平均值，或求多個變量的平

7、均值。語法格式使用如下：Average（a1,a2）; 或Average('a1:a10');a1、a2為組態王單元格所在的行號列標，或整型或實型變量。其中參數個數為1-32 個。當對報表的指定單元格區域內的單元格進行求平均值運算時，結果顯示在當前單元格內，語法格式使用如下：Average（a1,a2）;組態王命令語言函數速查手冊北京亞控科技發展有限公司5例如：任意單元格選擇求平均值:=Average（a1,b2,r10）;連續的單元格求平均值:=Average(b1:b10);或求變量的平均值：AverageValue= Average(lVar1,fVar1);BackUp

8、HistData此函數為組態王網絡中從IO 服務器上下載歷史數據記錄到歷史記錄服務器。用戶在歷史記錄服務器上調用該函數。函數的使用需要與組態王網絡配置相配合，具體內容參見組態王6.53 使用手冊中“歷史庫”一章。語法使用格式：BackupStationData (Str chMchinename, Long ftEndtime);參數：chMchinename 字符串型 為進行備份存儲的IO 服務器名ftEndtime 整型 為備份截止時間例如：/備份“IO 采集站”的歷史數據，截至時間為當前：endTime=HTConvertTime($年,$月,$日,$時,$分,0);BackUpHist

9、Data("IO 采集站", endTime);Bit此函數用以取得一個整型或實型變量某一位的值(0 或1)。用法：OnOff=Bit( Var , bitNo); /OnOff:離散變量參數：Var:整型或實型變量組態王命令語言函數速查手冊北京亞控科技發展有限公司6bitNo:位的序號，取值1 至16返回值：離散型。若變量Var 的第bitNo 位為0，返回值OnOff 為0；若變量Var 的第bitNo 位為1，返回值OnOff 為1。例如：開關=Bit(DDE1,6); 從變量DDE1 的第6 位得到變量“開關”狀態。BitSet此函數將一個整型或實型變量的任一位置為

10、指定值(0 或1)。語法格式：BitSet( Var, bitNo, OnOff);參數：Var:整型或實型變量bitNo:位的序號，取值1 至16OnOff:位的設定值注意：對于IO 變量來說，BitSet 函數只是用于可讀可寫的變量。例如：BitSet(DDE1,6,0); 將變量DDE1 的第6 位置為0。ChangePassword此函數顯示“更改口令”對話框，允許登錄工程人員更改他們的口令。使用格式：ChangePassword();例如：為畫面上某一按鈕設置命令語言連接：組態王命令語言函數速查手冊北京亞控科技發展有限公司7ChangePassword( );運行時單擊此按鈕，彈出對

11、話框：提示工程人員輸入當前的口令和新口令以及驗證新口令。完全正確后，工程人員的口令設置為新值。chartAdd此函數用于在指定的棒圖控件中增加一個新的條形圖。語法格式如下：chartAdd( "ControlName", Value, "label" );參數：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。Value：設定條形圖的初始值，整形數據, 實型數據。label：設定條形圖的標簽值，默認值=索引值Index，Index的取值范圍是1-16。例如：chartAdd( "XYChart", 1, &qu

12、ot;L6" );此語句將在棒圖控件XYChart 中增加一個標簽為L6 的條形圖，其初始值為1。組態王命令語言函數速查手冊北京亞控科技發展有限公司8chartClear此函數用于在指定的棒圖控件中清除所有的棒形圖。語法格式如下：chartClear( "ControlName" );參數：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。例如：chartClear( "XYChart" );此語句把棒圖控件XYChart 中的所有棒圖清除。chartSetBarColor此函數用于在指定的棒圖控件中設置餅圖的顏色。條形

13、圖不可以。語法格式如下：chartSetBarColor( "ControlName", barIndex,colorIndex );參數：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。barIndex: 整型變量，表示條形圖索引號，用于設定指定的條形圖，其取值范圍為0-15。colorIndex: 整型變量，表示條形圖的顏色索引號，用于設置指定條形圖的顏色，其取值范圍為0-15，顏色索引號和相應的顏色如下所示。顏色索引號 代表顏色 顏色索引號 代表顏色0 Default 8 Gray1 Blue 9 Light Blue2 Green 10 L

14、ight Green3 Cyan 11 Light Cyan組態王命令語言函數速查手冊北京亞控科技發展有限公司94 Red 12 Light Red5 Magenta 13 Light Magenta6 Yellow 14 Light Yellow7 White 15 Bright White16 Black例如：chartSetBarColor( "XYChart", 0, 1 );此語句將棒圖控件XYChart 中第一塊餅圖的顏色設為blue（即蘭色）。chartSetBarColor( "XYChart", 2, 4 );此語句將棒圖控件XYCha

15、rt 中第三塊餅圖的顏色設為red（即紅色）。chartSetValue此函數用于在指定的棒圖控件中設定/修改索引值為Index 的條形圖的數據。語法格式如下：chartSetValue( "ControlName", Index, Value );參數：ControlName：工程人員定義的棒圖控件名稱，可以為中文名或英文名。Value：設定條形圖的數據，整形數據, 實型數據。Index：條形圖的標簽值，Index 的取值范圍是0-15，組態王自動從0 開始加1，給每一個新增加的條形圖由小到大設定標簽值。例如：chartSetValue( "XYChart&qu

16、ot;,2, 30);此語句將在棒圖控件XYChart 中設定索引值為2（第三條）的條形圖的數據為 30。組態王命令語言函數速查手冊北京亞控科技發展有限公司10ClosePicture此函數用于將已調入內存的畫面關閉，并從內存中刪除。語法格式如下：ClosePicture("畫面名");例如：ClosePicture("反應車間"); 將關閉畫面“反應車間”。ConfigODBC此函數用于配置odbc 的數據源，語法格式如下：ConfigODBC(nDatatbasetype, szAttributes);參數：nDatatbasetype：數據庫類型，

17、目前支持 Access，SQL server該參數為 0 時表示數據庫類型為Access，參數為1 時表示數據庫類型為SQL server ；szAttributes：配置字符串:例1：配置 Access 數據庫，DSN 名稱為demo2，數據庫文件為E:Program FilesKingviewExampleKingdemo1數據庫.mdb。ConfigODBC(0,"DSN=demo20Description=E:ProgramFilesKingviewExampleKingdemo1數據庫.mdb0PWD=12340UID=shihf");例 2：配置 SQL 數據庫

18、：ConfigODBC(1, "DSN=MyDSN0 Description =SQLConfigDSN組態王命令語言函數速查手冊北京亞控科技發展有限公司11Sample0SERVER=MySQL0ADDRESS=MyServer0NETWORK=dbmssocn0DATABASE=pubs0");Cos此函數用于計算變量值的余弦值, 語法格式如下：Cos(數值或變量名);例如：Cos(90); 返回值為0Cos(temp); 返回變量“temp”的余弦值。Date此函數為根據給出的年、月、日整型數，返回日期字符串，默認格式為：年：月：日。語法使用格式如下：Date（LON

19、G nYear, LONG nMonth, LONG nDay）;例如：年、月、日變量分別為：“$年”、“$月”、“$日”，用日期來顯示由以上三個整數決定的“日期”字符串，則在命令語言中輸入：日期=Date（年,月,日）;DisplayMCI此函數提供了一個對多媒體設備的通用接口，具有強大的功能。語法使用格式：DisplayMCI( "MCICommand", option );下面舉例說明此函數的使用方法。例如：組態王命令語言函數速查手冊北京亞控科技發展有限公司12DisplayMCI(“PLAYCD”,3);用于播放CD 唱片中的第3 支歌曲。DisplayMCI(“S

20、TOPCD”,”);用于停止播放CD。DisplayMCI(“PLAYMIDI”,”);用于播放MIDI 格式的背景音樂”。DisplayMCI(“PAUSEMIDI”,”);暫停播放MIDI 格式的背景音樂”。DisplayMCI(“RESUMMIDI”,”);繼續播放MIDI 格式的背景音樂”。DisplayMCI(“CLOSEMIDI”,”);停止播放MIDI 格式的背景音樂”。DisplayMCI(“EJECTCD”);將光驅中的CD 盤片彈出。Dtext此函數用于按離散變量的值動態地改變字符串變量。語法格式如下：Str = Dtext(Discrete_Tag, OnMsg, Off

21、Msg)；參數 描述Discrete_Tag 離散變量名。OnMsg 字符串變量名OffMsg 字符串變量名當Discrete_Tag1 時，Str 的值為OnMsg當Discrete_Tag0 時，Str 的值為OffMsg例如：Str = Dtext(電源開關，"電源打開","電源關閉");當電源開關1 時，Str 的值為"電源打開"組態王命令語言函數速查手冊北京亞控科技發展有限公司13當電源開關0 時，Str 的值為"電源關閉"。EditUsers此函數常用于按鈕的命令語言連接，功能是在畫面程序運行中配置工程

22、人員。調用形式：EditUsers( );為配置其他工程人員，當前工程人員的權限必須不小于900。EnableNavigate此函數用于顯示/關閉導航圖。調用形式：EnableNavigate(is_enable);參數：is_enable，整型。0: is_enable 為0 時，關閉導航圖；1:is_enable 為1 時，顯示導航圖。使用 EnableNavigate 函數關閉導航圖后，除非使用該函數來顯示導航圖，否則無法顯示導航圖。例如：EnableNavigate(0); /關閉導航圖EnableSaveTagValueToIniValueWhenValueChange對于設置了“保

23、存數值”和“保存參數”的變量，使用該函數后，當變量的值和參數發生變化時，系統會自動將變量的值和參數保存到文件tagname.db 中，無論組態王運行系統是否正常退出，再次運行后，將保存的變量值和變量參數作為變量的初始值和初始參數?！氨４鏀抵怠焙汀氨４鎱怠钡木唧w含義請參見組態王手冊第七章 變量定義和管理 部分。調用形式：EnableSaveTagValueToIniValueWhenValueChange(is_enable);組態王命令語言函數速查手冊北京亞控科技發展有限公司14參數：is_enable：整型變量或數值1：當變量的值和參數發生變化時，保存變量數值和參數。組態王運行系統退出，再

24、次運行后，將保存的變量值和變量參數作為變量的初始值和初始參數。0：與組態王“保存數值”和“保存參數”實現的功能相同。例如：組態王開發系統數據詞典中定義變量，設置“保存數值”。執行函數：EnableSaveTagValueToIniValueWhenValueChange(1);該變量的值發生變化時，系統保存該變量的值。組態王運行系統退出，再次運行后，將保存的變量值作為變量的初始值。Exit此函數使組態王運行環境退出。調用形式：Exit(Option);參數：Option: 整型變量或數值0-退出當前程序；1-關機；2-重新啟動windows；Exp此函數返回指數函數ex 的計算結果，使用格式如

25、下：Exp(數值或變量名);例如：Exp(1); 返回e1 的計算值2.718Exp(temp); 計算e 常量的temp 次冪并返回計算結果。組態王命令語言函數速查手冊北京亞控科技發展有限公司15FileCopy此函數復制一個源文件到目的文件，它與 DOS 的 Copy 命令或者Windows 文件管理器中的 Copy 功能相似。調用格式：FileCopy( SourceFile，DestFile，DoneTag);參數 描述SourceFile 源文件名(包含完整的路徑)。DestFile 目的文件(包含完整的路徑)或目錄名(參見下面的例如子)。DoneTag 該參數目前無效。用來報告復制

26、過程進展情況的變量名稱。此參數須是一個內存長整數或內存模擬型，隨著復制過程的進行，該值從0 變化到100。返回值：成功返回1；不能啟動返回0；出錯返回-1；例如：Status=FileCopy("C:*.TXT", "C:BACKUP", DoneTag);Status：一個將被寫為1、-1 或0 的整型變量。FileCopy()函數在后臺執行，這樣它不會干擾組態王的運行。Status 表明的是復制過程是否已成功啟動。一旦復制過程已成功啟動，此過程成功結束，Status 被置為1。若此過程結束前發生錯誤，則Status 被置為-1。SourceFile

27、和 DestFile 一般為文件名。但用FileCopy() 函數復制單一文件時，目標文件名可以是一個目錄，如：FileCopy("C:DATA.TXT", "C:BACKUP", DoneTag);組態王命令語言函數速查手冊北京亞控科技發展有限公司16將把文件“”復制到“C：”驅動器上一個叫做“BACKUP”的目錄下。變量 Monctor 在復制完成后置為1。若 SourceFile 包含任何通配符的話，DestFile 必須是一個目錄(而非文件名)，否則此函數將返回一個錯誤代碼，如：FileCopy("C:*.TXT", &quo

28、t;C:BACKUP", DoneTag);將把C 盤根目錄下所有的.TXT 文件復制到C：BACKUP 目錄下。FileDelete此函數刪除不需要或不想要的文件。調用格式：FileDelete(Filename);參數 描述Filename 要刪除的文件名。若找到要刪除的文件，并成功地刪除，此函數將返回1，否則此函數返回0。例如：Status=FileDelete("C:DATA.TXT");若在 C:找到 "DATA.TXT" 則Status 等于1, 未找到該文件則為0。FileMove此函數與 FileCopy ()函數相似，但只是將

29、文件從一個位置轉移到另一個位置，而不是復制。調用格式：FileMove(SourceFile, DestFile, DoneTag);參數 描述組態王命令語言函數速查手冊北京亞控科技發展有限公司17SourceFile 源文件名(包含完整的路徑)DestFile 目的文件名(包含完整的路徑)DoneTag 用來報告移動過程進展情況的變量名稱。此參數須是一個內存長整數或內存模擬型，隨著轉移過程的進行，該值從0 變化到100。返回值：成功返回1；不能啟動返回0；出錯返回-1；例如：Status=FileMove("C:DATA.TXT","D:DATA.TXT&quo

30、t;,Monitor);Status 是一個將被寫為1、-1 或0 的整型變量。Monitor ：在數據詞典中定義過的內存整數。FileMove() 函數在后臺執行，這樣它不會干擾“組態王”的運行。使用 DoneTag 是為了允許應用程序或工程人員監視轉移操作的進展。用這種方法，在轉移過程啟動后可能發生的任何錯誤都能使工程人員察覺。（此處用變量Monitor監測）這與上述返回的Status 不同，Status 表明的是轉移過程是否已成功啟動。一旦轉移過程已成功啟動，Monitor 就會被賦值0。隨著轉移過程的進行，該值不斷增加。當此過程成功結束時達到100，Status 被置為1。若此過程結束

31、前發生錯誤，Status 被置為-1。若源文件和目的文件位于同一驅動器上，此函數可以簡單地更改此文件的目錄參照表(計算機在此表中保存磁盤上的文件名和存儲位置)，而不用實際轉移任何數據。在這種情況下，不管此文件的大小，轉移操作將會很快。若源文件和組態王命令語言函數速查手冊北京亞控科技發展有限公司18目的文件位于不同的驅動器上，轉移操作所費的時間將隨文件的大小不同而不同。這是因為數據必須由一個物理磁盤傳送到另一物理磁盤上，如：FileMove("C:DATA.TXT","C:BACKUPDATA.TXT",Monitor);將把“C”驅動器上根目錄下的名為“

32、DATA.TXT 的文件轉移到名為“BACKUP”的目錄下，變量 Monitor 在轉移完成后將被置為 1。此函數也可用于文件更名，只要源文件和目的文件指定了相同的目錄，但不同的文件名，如：FileMove ("C:DATA.TXT","C:DATA.BAK",Monitor);將把C 盤根目錄下文件“”更名為“”。變量Monitor 在其完成后被置為1。FileReadFields此函數從一個指定文件中讀出 CSV(逗號分隔變量)記錄。調用格式：FileReadFields(Filename,FileOffset,”StartTag”,NumberOf

33、Fields);參數 描述Filename 指定要讀的文件。FileOffset 指定讀此文件的起始位置。若為1，則表明從頭開始StartTag 指定第一個數據要寫到的那個組態王變量的名稱。此變量名必須以一個數字結尾(如MyTag1)。此參數必須是一個表明變量名的字符串(而非實際的變量本身)。所以，若變量叫做 MyTag1，就需要給出MyTag1 或MyT，而不僅僅是MyTag1。NumberOfFields 指定要讀的字段數目(此文件的每條記錄中組態王命令語言函數速查手冊北京亞控科技發展有限公司19以逗號隔開的字段的數目)。若StartTag 為“MyTag1”而Number

34、OfField 為3，則有3個字段從文件中讀出并保存在MyTag1、MyTag2 和MyTag3 中。這些具有連續名字的變量必須先在組態王中創建，并可以屬于不同的類型(整型，文字等等)。例如：若C：DATAFILE.CSV 的第一行內容為：“This is text, 3.1416, 5”，調用函數BytePosition=FileReadFields("C:DATAFILE.CSV",1,"MyTag1", 3);將讀出此行，并把“This is text"保存在MyTag1 中，3.1416 保存在 MyTag2 中，5 保存在 MyTag

35、3 中：此函數在讀出之后返回新的字節位置。你可以在下次讀時使用此返回值作為FileOffset 的值，如：BytePosition=FileReadFields(c:DATAFILE.CSV",FileOffset,"MyTag1",3);注意:StartTag 兩側必須加引號。FileReadStr此函數從指定文件中讀出一指定數目的字節(或一整行)。調用格式：FileReadStr(Filename,FileOffset,Str_Tag,CharsToRead);參數 描述Filename 指定要讀的文件。FileOffset 指定讀此文件的起始位置。若為1，則

36、表明從頭開始。Str_Tag 指定將從文件中讀出的數據保存于何處。CharsToRead 指定要從文件中讀出多少字節。為處理文本組態王命令語言函數速查手冊北京亞控科技發展有限公司20文件，可將CharsToRead 置為0，函數從文件中一直讀到下一個 LF(換行符)。此函數在讀出之后返回新的字節位置?？梢栽谙麓巫x時使用此返回值作為 FileOffset 值。例如：FileReadStr ("C:DATAFILE.TXT", 1, Str_Tag, 0);文件“”的第一行將被讀出并保存到Str_Tag 中。FileWriteFields此函數往指定文件寫入CSV(逗號分隔變量

37、)記錄。調用格式：FileWriteFields(Filename,FileOffset,”StartTag”,NumberOfFields);參數 描述Filename 指定要寫的文件。若文件不存在，則創建它。FileOffset 指定寫此文件的起始位置。若 FileOffset 為 0，此函數將寫到文件末尾。若為1，則寫到開頭。StartTag 指定第一個數據項的變量名稱。此變量名必須以一個數字結尾(如MyTag1)。此參數必須是一個表明變量名的字符串(而非實際的變量本身)。比如，變量名為MyTag1，就需要給出”MyTag1”（注意引號）或MyT，而不僅僅是MyTag1。

38、NumberOfFields 指定要寫的字段數目(此文件的每條記錄中以逗號隔開的字段的字段數目)。此函數在寫入之后返回新的字節位置。可以在下次調用函數時使用此返回值作為FileOffset 值。若 StartTag 為“MyTag1”，而NumberOfFields 為3，則有3 個字段被寫入文件中(寫入的是 MyTag1、MyTag2 和 MyTag3)。這些具組態王命令語言函數速查手冊北京亞控科技發展有限公司21有連續名字的變量必須先在組態王中創建，并可以屬于不同的類型(整型，字符串等等)。例如：將一行“This is text 3.1416，5”寫到文件C的第一行中?！癟his is t

39、ext”是 MyTag是 MyTag2 的當前值，5 是 MyTag3 的當前值。調用函數FileWriteFields ("C:DATAFILE.CSV", 1, "MyTag1",3);若將文本串MyTag1 寫到C：DATAFILE.CSV 的末尾，調用函數FileWriteFields ("C:DATAFILE.CSV", 0, "MyTag1",3);StartTag 兩側必須加引號。FileWriteStr此函數往指定文件寫入指定數目的字節(或一整行)。調用格式：FileWriteStr(Filenam

40、e,FileOffset,String,LineFeed);參數 描述Filename 指定寫入的文件。若文件不存在，則創建它。FileOffset 指定此文件的起始位置。若 FileOffset 為 0，此函數將寫到文件末尾。若為1，則寫到開頭String 指定要寫入文件中的字符。LineFeed 規定是否在寫操作之后添加換行。當寫入一文本文件時，可以把LineFeed 置為1。此函數在寫入后返回新的字節位置。你可以在下次寫時將此返回值當作FileOffset() 函數的返回值來使用。組態王命令語言函數速查手冊北京亞控科技發展有限公司22例如：將名為MsgTag 的字符串變量寫入文件C:DA

41、TAFILE.TXT 的末尾。調用函數：FileWriteStr ("C:DATAFILE.TXT", 0, MsgTag, 1);GetBackupProgress此函數用于在組態王進行網絡歷史數據備份合并時獲得進度百分比。使用時需要通過命令語言調用來獲得進度值。語法使用格式：GetBackupProgress( str szStationName);參數：szStationName 遠程站點名稱。返回值：整型，為0100 間的進度值。例如：備份進度= GetBackupProgress(“IO 采集站”);GetDate此函數將以秒為單位的長整型數轉換為相應的日期數值，

42、分別以年、月、日等的日期數值輸出。該長整型秒數的基準為UTC(格林尼治)時間1970 年1 月1 日00:00:00。轉換完成輸出的日期也為UTC(格林尼治)日期。語法使用格式GetDate(DateTime,Year,Month,Day);參數 描述DateTime： 需要進行日期轉換的數，整型，為輸入參數Year： 年，整型，轉換后得到的數據，輸出參數Month： 月，整型，轉換后得到的數據，輸出參數Day： 日，整型，轉換后得到的數據，輸出參數組態王命令語言函數速查手冊北京亞控科技發展有限公司23例如：自UTC(格林尼治)時間1970 年1 月1 日00:00:00 到2003 年8 月

43、8 日0:8:9 的秒的數值為1060301289，使用GetDate()函數可以從這個數值中分離出所表示的日期年、月、日。函數 GetDate(1060301289,年,月,日); 執行后，得到的“年”的值為2003，“月” 的值為8，“日” 的值為 8。獲得其中時間的函數為GetTime()。GetDatelocal此函數將以秒為單位的長整型數轉換為相應的日期數值，分別以年、月、日的日期數值輸出。該長整型秒數的基準為UTC(格林尼治)時間1970 年1 月1 日00:00:00。轉換完成輸出的日期為本地日期。語法使用格式GetDatelocal(DateTime,Year,Month,Da

44、y);參數 描述DateTime： 需要進行日期轉換的數，整型，為輸入參數Year： 年，整型，轉換后得到的數據，輸出參數Month： 月，整型，轉換后得到的數據，輸出參數Day： 日，整型，轉換后得到的數據，輸出參數例如：使用HTConvertTime 函數將自UTC(格林尼治)時間1970 年1月1 日00:00:00 到北京時間2006 年9 月26 日9:22:4 轉換為以秒為單位的長整數數值為1159233724，使用GetDatelocal 函數可以從這個數值中分離出所表示的北京日期年、月、日。GetDatelocal (1159233724,年,月,日);執行后，得到的“年”的值

45、為2006，“月” 的值為9，“日”的值為 26。組態王命令語言函數速查手冊北京亞控科技發展有限公司24GetGroupName此函數為通過報警組ID 號獲得報警組名稱。在組態王中，每個報警組除了名稱外，還有ID 號。組態王的變量域“.Group”顯示的是變量所屬報警組的ID 號，如果要獲得相應的報警組名稱，就需要使用該函數。語法使用格式sGroupName= GetGroupName(StationName,GroupID);參數 描述StationName： 報警組所在的站點名稱（該項暫時無效，使用時用空字符串代替）GroupID： 要獲取名稱的報警組的ID 號返回值為字符串型。例如：Gr

46、oupName=GetGroupName(“”, 本站點原料罐液位.Group);GetKey此函數為獲得組態王當前使用的加密鎖的序列號。語法使用格式KeyID=GetKey();該函數沒有任何參數。返回值為字符串型。GetPictureScrollXPos此函數用于獲取目標畫面當前窗口的左上角的X 坐標值。語法使用格式GetPictureScrollXPos(STRING PictureName);參數 描述PictureName：畫面名稱組態王命令語言函數速查手冊北京亞控科技發展有限公司25返回值為目標畫面當前窗口的左上角的X 坐標值。例如：xx=GetPictureScrollXPos(

47、"監控中心");GetPictureScrollYPos此函數用于獲取目標畫面當前窗口的左上角的Y 坐標值。語法使用格式GetPictureScrollYPos(STRING PictureName);參數 描述PictureName：畫面名稱返回值為目標畫面當前窗口的左上角的 Y 坐標值。例如：yy=GetPictureScrollYPos ("監控中心");GetProjectPath此函數用于獲取當前工程的路徑。語法使用格式GetProjectPath();例如：在組態王數據詞典中定義內存字符串變量VarName：VarName=GetProjec

48、tPath();GetRealDBForBool此函數用于獲取變量的當前實時離散值。語法使用格式GetRealDBForBool( "VarName");參數 描述組態王命令語言函數速查手冊北京亞控科技發展有限公司26VarName：變量名稱，字符串格式說明：變量只能是離散量。返回值為離散型。例如：bb= GetRealDBForBool( "原料油出料閥");GetRealDBForFloat此函數用于獲取變量的當前實時模擬值。語法使用格式GetRealDBForFloat ("VarName");參數 描述VarName： 變量名

49、稱，字符串格式說明：變量只能是實型變量。例如：ff= GetRealDBForFloat ( "原料油液位");GetRealDBForInt此函數用于獲取變量的當前實時整型值。語法使用格式GetRealDBForInt ( "VarName");參數 描述VarName： 變量名稱，字符串格式說明：變量只能是整型變量。例如：ii= GetRealDBForInt ( "水果");組態王命令語言函數速查手冊北京亞控科技發展有限公司27GetRealDBForString此函數用于獲取變量的當前實時字符串型值。語法使用格式GetReal

50、DBForString ( "VarName");參數 描述VarName： 變量名稱，字符串格式說明：變量只能是字符串型變量。例如：ss= GetRealDBForString ( "記錄日期");GetStationStatus此函數用于在組態王進行網絡歷史數據備份合并時獲得備份的狀態。使用時需要通過命令語言調用來獲得狀態值。語法使用格式：BOOL GetStationStatus( str szStationName);參數：szStationName 遠程站點名稱。返回值：離散型， >0 正在備份數據 =0 空閑。例如：備份狀態= GetS

51、tationStatus (“IO 采集站”);GetTime此函數將以秒為單位的長整型數轉換為相應的時間數值，分別以時、分、秒等的時間數值輸出。該長整型秒數的基準為UTC(格林尼治)時間1970 年1 月1 日00:00:00。轉換完成輸出的時間也為UTC(格林尼治)時間。語法使用格式GetTime(DateTime,Hour,Minute,Second);參數 描述組態王命令語言函數速查手冊北京亞控科技發展有限公司28DateTime： 需要進行時間轉換的數，整型，為輸入參數Hour： 時，整型，轉換后得到的數據，輸出參數Minute： 分，整型，轉換后得到的數據，輸出參數Second： 秒，整型，轉換后得到的數據，輸出參數例如：自UTC(格林尼治)時間1970 年1 月1 日00:00:00 到2003 年8 月8 日0:8:9 的秒的