倍福PLC学习：获取系统时间

今天这篇文章，我们来介绍下如何使用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;

如下图所示：

声明变量.PNG

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

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

输入助手.png

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

函数定义.png

各参数的定义如下：

NETID：输入数据，字符串类型，表示TC3控制器的AmsNetID。如果是在本地运行，该参数可为空；
START：输入数据，布尔类型，上升沿信号启动函数执行；
TMOUT：输入数据，TIME类型，读取超时的时间设置值；
BUSY：输出数据，布尔类型，1=正在读取；
ERR：输出数据，布尔类型，1=读取时间发生错误。0=无错误；
TIMESTR：输出数据，时间结构体（TIMESTRUCT），存放读取到的时间信息；

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

TYPE TIMESTRUCTSTRUCT
   wYear            : WORD;
   wMonth            : WORD;
   wDayOfWeek        : WORD;
   wDay          : WORD;
   wHour          : WORD;
   wMinute        : WORD;
   wSecond        : WORD;
   wMilliseconds     : WORD;
END_STRUCTEND_TYPE

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