如何使用TwinCAT3内部的函数来获取系统时间？

今天这篇文章，我们来介绍下如何使用TwinCAT3内部的函数来获取系统时间。

打开TwinCAT3（以下简称TC3）并新建项目，在项目树的“PLC”中添加标准PLC，命名为“CPU1”。默认情况下，“References（引用）”中会添加标准库“Tc2_Standard”、“Tc2_System”和“Tc3_Module”，如下图所示：

Tc2_System库中也有时间相关的函数，比如F_GetSystemTime，它返回一个时间戳。虽然它可也可以转换成年-月-日的形式，但是本文暂时不介绍该函数，我们使用另外一个库中的函数。

为了获取系统时间，我们添加一个库文件。在“References（引用）”右键单击，选择“Add libaray（添加库）”，在弹出对话框的顶部搜索框中输入“tc2_u”进行搜索，找到“Tc2_Utilites”，单击“OK”按钮将其添加到“References（引用）”中，如下图所示：

在Main中声明函数getSystemTime（TC3中所有函数/函数块都必须先声明才能使用）

getSystemTime:NT_GetTime;

如下图所示：

这里的“NT_GetTime”是“Tc2_Utilites”库中的函数，它用来获取Windows系统的时间，并存储到一个TIMESTRUCT结构体变量中。由于TC3是基于Windows的自动化技术，因此使用该函数获取控制器中Windows操作系统的时间。

在主程序代码区按F2可调出输入助手（Input assitant）。单击“Instance Calls”可看到之前声明的函数getSystemTime，如下图所示：

单击“OK”按钮会自动添加该函数，如下图所示：

各参数的定义如下：

NETID：输入数据，字符串类型，表示TC3控制器的AmsNetID。如果是在本地运行，该参数可为空；

START：输入数据，布尔类型，上升沿信号启动函数执行；

TMOUT：输入数据，TIME类型，读取超时的时间设置值；

BUSY：输出数据，布尔类型，1=正在读取；

ERR：输出数据，布尔类型，1=读取时间发生错误。0=无错误；

TIMESTR：输出数据，时间结构体（TIMESTRUCT），存放读取到的时间信息；

时间结构体（TIMESTRUCT）的定义如下：

TYPETIMESTRUCT STRUCT wYear:WORD; wMonth:WORD; wDayOfWeek:WORD; wDay:WORD; wHour:WORD; wMinute:WORD; wSecond:WORD; wMilliseconds:WORD; END_STRUCT END_TYPE

结构体中各变量的数据类型均为字（word），其中：

wYear：年份，取值范围：1970 ~ 2106；

wMonth：月份，取值范围：1 ~ 12；

wDayOfWeek：一周的第几天，取值范围: 0 ~ 6 (周日 = 0)；

wDay: 日份，取值范围：1 ~ 31；

wHour：小时，取值范围：0 ~ 23；

wMinute：分钟，取值范围：0 ~ 59；

wSecond：秒，取值范围：0 ~ 59；

wMilliseconds：微秒，取值范围：0 ~ 999；

主程序编写代码如下：

编译程序，并下载登录，查看系统时间，如下图所示：

好了，关于倍福PLC获取系统时间的方法就先介绍到这里。

审核编辑：刘清