16 组态王命令语言函数速查手册
ＨＴＧｅｔＰｅｎＲｅａｌＶａｌｕｅ
此函数用于获取指定历史趋势曲线中的趋势笔所对应的实际值。
调用格式：
ＨＴＧｅｔＰｅｎＲｅａｌＶａｌｕｅ（ＨｉｓｔｒｏｙＮａｍｅ，ＰｅｎＮｕｍ，ＣｏｎｔｅｎｔＳｔｒｉｎｇ）
参数说明
ＨｉｓｔｒｏｙＮａｍｅ 指在“历史趋势曲线”对话框中定义的历史趋势曲线
名称
ＰｅｎＮｕｍ 与历史趋势曲线中的一个变量相对应的趋势笔的索引
号
ＣｏｎｔｅｎｔＳｔｒｉｎｇ 字符串常量
“ｓｔａｒｔ” 表示获取与历史趋势曲线的域ＶａｌｕｅＳｔａｒｔ相对应的
实际值，ＶａｌｕｅＳｔａｒｔ是用工程百分比来表示变量的下限值，ｓｔａｒｔ则表示将下限值的工程百分比转换为实际值。
“ｅｎｄ” 表示获取与历史趋势曲线的域ＶａｌｕｅＥｎｄ相对应的实
际值，ＶａｌｕｅＥｎｄ是用工程百分比来表示变量的上限值，ｅｎｄ则表示将上限值的工程百分比转换为实际值。
例如：
设有一温度历史曲线，其最大上限值为５００，最小下限值为０， 如下图所示：
最大上限值 500 对应的工程百分比为100% 对应的工程百分比为0% 最小下限值 0
如果用ＶａｌｕｅＳｔａｒｔ和ＶａｌｕｅＥｎｄ输出显示，则显示的数据是温度值的工程百分比，如ＶａｌｕｅＥｎｄ 的输出为５０，表示百分比是
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 17
５０％，如果使用函数语句
ＨＴＧｅｔＰｅｎＲｅａｌＶａｌｕｅ（ｈｉｓｔｒｏｙ，１，“ｅｎｄ”）；
则函数返回工程百分比５０％对应的实际值５００＊５０％＝２５０，其中ｈｉｓｔｏｒｙ为历史趋势曲线名，１表示对应温度的趋势笔。
ＨＴＧｅｔＴｉｍｅＡｔＳｃｏｏｔｅｒ
此函数返回一个长整数，表示以ＧＭＴ（格林尼治时间）１９６９年１２月３１日１６：００：００为起点的以秒计的相对时间，指示器位置由 ＳｃｏｏｔＮｕｍ 和 ＳｃｏｏｔＬｏｃ 指定。 调用格式：
ＩｎｔｅｇｅｒＲｅｓｕｌｔ＝ＨＴＧｅｔＴｉｍｅＡｔＳｃｏｏｔｅｒ（Ｈｉｓｔ＿Ｔａｇ， ＳｃｏｏｔＮｕｍ ）； 参数 描述
Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名。
ＳｃｏｏｔＮｕｍ 整数，代表左或右指示器（１＝左指示器，２＝右指示器）。 当趋势曲线的ＣｈａｒｔＳｔａｒｔ、ＣｈａｒｔＬｅｎｇｔｈ、ＳｃｏｏｔＮｕｍ或指示器位置改变时都会引起此表达式被计算。 例如：
下面的语句在趋势曲线Ｔｒｅｎｄ１左指示器的当前位置给出以秒为单位的时间值：
ＴｉｍｅＬｅｎｇｔｈ＝ＨＴＧｅｔＴｉｍｅＡｔＳｃｏｏｔｅｒ（Ｔｒｅｎｄ１ ，１）；
ＨＴＧｅｔＴｉｍｅＳｔｒｉｎｇＡｔＳｃｏｏｔｅｒ
此函数返回包含时间／日期的字符串，指示器的位置由 ＳｃｏｏｔＮｕｍ 和 ＳｃｏｏｔＬｏｃ 指定。调用格式：
ＭｅｓｓａｇｅＲｅｓｕｌｔ＝ＨＴＧｅｔＴｉｍｅＳｔｒｉｎｇＡｔＳｃｏｏｔｅｒ（Ｈｉｓｔ＿Ｔａｇ， ＳｃｏｏｔＮｕｍ ， Ｆｏｒｍａｔ＿Ｔｅｘｔ）；
参数 描述 Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名。 ＳｃｏｏｔＮｕｍ 整数，代表左或右指示器（１＝左指示器，２＝右指示
器）。
Ｆｏｒｍａｔ＿Ｔｅｘｔ 指定要使用的时间／时期格式的字符串。可为下列值
之一。
＂Ｄａｔｅ＂ 以 Ｗｉｎｄｏｗｓ 控制面板相同的格式显示日期。
北京亚控自动化软件科技有限公司
18 组态王命令语言函数速查手册
＂Ｔｉｍｅ＂
＂ＤａｔｅＴｉｍｅ＂ 以 Ｗｉｎｄｏｗｓ 控制面板相同的格式显示时间。 同时显示日期和时间。
当趋势曲线的ＣｈａｒｔＳｔａｒｔ、ＣｈａｒｔＬｅｎｇｔｈ、ＳｃｏｏｔＮｕｍ或指示器位置改变时都会引起此表达式被计算。字符串的格式决定了返回值的内容。． 例如：
在变量为Ｔｒｅｎｄ１的右指示器的当前位置给出日期／时间值。这个值被存在字符串变量 ＮｅｗＲｉｇｈｔＴｉｍｅＳｔｒｉｎｇ 中，格式是”Ｔｉｍｅ”，调用函数
ＮｅｗＲｉｇｈｔＴｉｍｅＳｔｒｉｎｇ＝ＨＴＧｅｔＴｉｍｅＳｔｒｉｎｇＡｔＳｃｏｏｔｅｒ （ Ｔｒｅｎｄ１， ２， ＂Ｔｉｍｅ＂ ）；
ＨＴＧｅｔＶａｌｕｅ
此函数返回一个按整个趋势的指定笔所要求的类型的值。调用格式：
ＲｅａｌＲｅｓｕｌｔ＝ＨＴＧｅｔＶａｌｕｅ（Ｈｉｓｔ＿Ｔａｇ， ＰｅｎＮｕｍ，ＶａｌＴｙｐｅ＿Ｔｅｘｔ）；
参数 描述 Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名。 ＰｅｎＮｕｍ 代表笔号的整型变量或值。（１到８ ）
ＶａｌＴｙｐｅ＿Ｔｅｘｔ 表明返回值类型的字符串。可以是以下字符串之一。 ＂ＡｖｅｒａｇｅＶａｌｕ整个趋势的平均值。 ｅ＂
＂ＭａｘＶａｌｕｅ＂ 整个趋势的最大值。 ＂ＭｉｎＶａｌｕｅ＂ 整个趋势的最小值。
此函数返回一内存实型变量，它代表按给出类型算出的值。 例如：
下面的语句得到趋势 Ｔｒｅｎｄ１ 的 Ｐｅｎ２ 所取得数据的最大值。算出的值存到内存实型变量ＬｅｆｔＨｅｍｉｓｐｈｅｒｅＳＤ中：
ＬｅｆｔＨｅｍｉｓｐｈｅｒｅＳＤ＝ＨＴＧｅｔＶａｌｕｅ（Ｔｒｅｎｄ１，２ ， ＂ＭａｘＶａｌｕｅ＂）；
ＨＴＧｅｔＶａｌｕｅＡｔＳｃｏｏｔｅｒ
此函数返回一个样本在指定的指示器位置、趋势和笔号所要求的类型的的值。调用格式：
ＲｅａｌＲｅｓｕｌｔ＝ＨＴＧｅｔＶａｌｕｅＡｔＳｃｏｏｔｅｒ（Ｈｉｓｔ＿Ｔａｇ，ＳｃｏｏｔＮｕｍ， ＰｅｎＮｕｍ， ＶａｌＴｙｐｅ＿Ｔｅｘｔ）；
北京亚控自动化软件科技有限公司
组态王命令语言函数速查手册 19
描述
历史趋势变量，代表趋势名。
代表左或右指示器的整数（１＝左指示器，２＝右指示器）。
ＰｅｎＮｕｍ 代表笔号的整型变量或值。（１到８）
ＶａｌＴｙｐｅ＿Ｔｅｘｔ 代表返回值类型的字符串，可以为以下字符串之一： ＂Ｖａｌｕｅ＂ 取得在指示器位置处的值。 ＂Ｖａｌｉｄ＂ 判断取得的值是否有效。返回值为０表示取得的
值无效，为１表示有效。
若是“Ｖａｌｕｅ”类型，则返回模拟值。若是“Ｖａｌｉｄ”类型，则返回离散值。 例如：
采集趋势曲线Ｔｒｅｎｄ１的笔Ｐｅｎ３在右指示器的当前值。若此值有效，则在内存离散变量ＶａｌｉｄＦｌａｇ中存入１，无效，则存入０：
ＶａｌｉｄＦｌａｇ＝ＨＴＧｅｔＶａｌｕｅＡｔＳｃｏｏｔｅｒ（Ｔｒｅｎｄ１，２，３ ， ＂Ｖａｌｉｄ＂）；
参数
Ｈｉｓｔ＿Ｔａｇ ＳｃｏｏｔＮｕｍ
ＨＴＧｅｔＶａｌｕｅＡｔＺｏｎｅ
此函数返回一包含在某一趋势指定笔的左右指示器之间的数据中所要求类型的值。调用格式：
ＲｅａｌＲｅｓｕｌｔ＝ＨＴＧｅｔＶａｌｕｅＡｔＺｏｎｅ（Ｈｉｓｔ＿Ｔａｇ，ＰｅｎＮｕｍ， ＶａｌＴｙｐｅ＿Ｔｅｘｔ ）；
参数 描述 Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名。 ＰｅｎＮｕｍ 代表笔号的整型变量或值。（１到８） ＶａｌＴｙｐｅ＿Ｔｅｘｔ 表明要返回值的类型的字符串，可以是以下３个字
符串之一：
＂ＡｖｅｒａｇｅＶａｌｕｅ左右指示器间区域上的平均值。 ＂
＂ＭａｘＶａｌｕｅ＂ 左右指示器间区域上的最大值。 ＂ＭｉｎＶａｌｕｅ＂ 左右指示器间区域上的最小值。 此函数直接使用运行数据库的趋势变量的．ＳｃｏｏｔｅｒＰｏｓＬｅｆｔ和．ＳｃｏｏｔｅｒＰｏｓＲｉｇｈｔ域来确定区域边界，并返回计算值。
北京亚控自动化软件科技有限公司
20 组态王命令语言函数速查手册
例如：
取得趋势曲线“Ｔｒｅｎｄ１”的 Ｐｅｎ１代表的变量左右指示器之间的平均值，并把结果存入内存实型变量 ＡｖｇＶａｌｕｅ 中。调用函数
ＡｖｇＶａｌｕｅ＝ＨＴＧｅｔＶａｌｕｅＡｔＺｏｎｅ（Ｔｒｅｎｄ１， １， ＂ＡｖｅｒａｇｅＶａｌｕｅ＂）；
ＨＴＳｃｒｏｌｌＬｅｆｔ
此函数将趋势曲线的起始时间左移（提前）给定的百分比值。百分比是相对于趋势曲线的时间轴长度。移动后时间轴的长度保持不变。调用格式：
ＨＴＳｃｒｏｌｌＬｅｆｔ（Ｈｉｓｔ＿Ｔａｇ，Ｐｅｒｃｅｎｔ）；
参数 描述
Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名。
Ｐｅｒｃｅｎｔ 实数，代表图表要滚动的百分比（０．０到１００．０）。 例如：
将趋势曲线Ｔｒｅｎｄ１的时间轴向左滚动（提前）１０％，调用函数 ＨＴＳｃｒｏｌｌＬｅｆｔ（Ｔｒｅｎｄ１，１０．０）；
若当前显示起始于下午 １２：００：００ ，而且显示宽度为６０秒。在函数执行后，新的趋势曲线将起始于上午 １１：５９：５４。
ＨＴＳｃｒｏｌｌＲｉｇｈｔ
此函数将趋势曲线的起始时间右移给定的百分比值。百分比是相对于趋势曲线的时间轴长度。移动后时间轴的长度保持不变。调用格式：
ＨＴＳｃｒｏｌｌＲｉｇｈｔ（Ｈｉｓｔ＿Ｔａｇ，Ｐｅｒｃｅｎｔ）；
参数 描述 Ｈｉｓｔ＿Ｔａｇ 历史趋势变量，代表趋势名。 Ｐｅｒｃｅｎｔ 实数，代表图表要滚动的百分比（０．０到１００．０）。 例如：
将趋势曲线Ｔｒｅｎｄ１的间轴范围向右滚动 ２０％。调用函数 ＨＴＳｃｒｏｌｌＲｉｇｈｔ（Ｔｒｅｎｄ１，２０．０）；
若当前显示起始于下午 １２：００：００，而且显示宽度为６０秒，则新的趋势将起始于下午 １２：００：１２ （在函数执行后）。
北京亚控自动化软件科技有限公司