本页目录

GetTickCountUs

位置

sys_plc_time.aclib

功能说明

获取时间计数，单位us。

参数说明

输出参数	数据类型	描述	掉电保持	常量
GetTickCountUs	ULINT	返回us时间	×	×

示例
- 示例功能说明获取微秒时间。
- 变量定义
  变量名数据类型初值注释
  uiTimeUs ULINT 微秒时间
- CFC示例
- ST示例 uiTimeUs := GetTickCountUs();
- LD示例

GetTickCountMs

位置

sys_plc_time.aclib

功能说明

获取时间计数，单位ms。

参数说明

输出参数	数据类型	描述	掉电保持	常量
GetTickCountMs	UDINT	返回ms时间	×	×

示例
- 示例功能说明获取毫秒时间。
- 变量定义
  变量名数据类型初值注释
  uiTimeMs UDINT 毫秒时间
- CFC示例
- ST示例 uiTimeMs := GetTickCountMs();
- LD示例

GetDateAndTime

位置

sys_plc_time.aclib

功能说明

获取系统时间。

参数说明

输入参数	数据类型	描述	掉电保持	常量
EN_Rising	BOOL	上升沿使能	×	×

输出参数	数据类型	描述	掉电保持	常量
xDone	BOOL	TRUE: 操作已成功完成	×	×
xBusy	BOOL	TRUE: 操作还在进行中	×	×
xError	BOOL	TRUE: 发生故障，功能块执行异常终止FALSE: 无异常	×	×
eError	emPLCTimeErrorCode	故障诊断信息	×	×
dtDateAndTime	DT	读取的系统时间	×	×

示例
- 示例功能说明获取当前系统时间。
- 变量定义
  变量名数据类型初值注释
  GetDateAndTime_inst0 GetDateAndTime
  EnGetDateAndTime BOOL
  xDone BOOL
  xBusy BOOL
  xErr BOOL
  eErr emPLCTimeErrorCode
  dtSysTime DT
- CFC示例
- ST示例 GetDateAndTime_inst0(EN_Rising := EnGetDateAndTime , xDone => xDone , xBusy => xBusy , xError => xErr , eError => eErr , dtDateAndTime => dtSysTime );
- LD示例

SetDateAndTime

位置

sys_plc_time.aclib

功能说明

设置系统时间。

参数说明

输入参数	数据类型	描述	掉电保持	常量
EN_Rising	BOOL	上升沿使能	×	×
dtPresetDateAndTime	DT	预设置的系统时间	×	×

输出参数	数据类型	描述	掉电保持	常量
xDone	BOOL	TRUE: 操作已成功完成	×	×
xBusy	BOOL	TRUE: 操作还在进行中	×	×
xError	BOOL	TRUE: 发生故障，功能块执行异常终止FALSE: 无异常	×	×
eError	emPLCTimeErrorCode	故障诊断信息	×	×

示例
- 示例功能说明设置系统时间为2020-10-16-15:00:00
- 变量定义
  变量名数据类型初值注释
  SetDateAndTime_inst0 SetDateAndTime
  EnSetDateAndTime BOOL
  dtPresetSysTime DT DT#2020-10-16-15:00:00
  xDone BOOL
  xBusy BOOL
  xErr BOOL
  eErr emPLCTimeErrorCode
- CFC示例
- ST示例 SetDateAndTime_inst1(EN_Rising := EnSetDateAndTime , dtPresetDateAndTime := dtPresetSysTime , xDone => xDone , xBusy => xBusy , xError => xErr , eError => eErr );
- LD示例

RTC

位置

sys_plc_time.aclib

功能说明

相对于某时刻开始计时。

参数说明

输入参数	数据类型	描述	掉电保持	常量
EN_Rising	BOOL	上升沿使能	×	×
dtPresetDateAndTime	DT	计时起始时间	×	×

输出参数	数据类型	描述	掉电保持	常量
xDone	BOOL	TRUE: 操作已成功完成	×	×
xBusy	BOOL	TRUE: 操作还在进行中	×	×
xError	BOOL	TRUE: 发生故障，功能块执行异常终止FALSE: 无异常	×	×
eError	emPLCTimeErrorCode	故障诊断信息	×	×
dtDateAndTime	DT	当前计时时间	×	×

示例
- 示例功能说明从相对于DT#2021-9-1-12:00:00时刻开始计时。
- 变量定义
  变量名数据类型初值注释
  RTC_inst0 RTC
  EnRTC BOOL
  dtStartTime DT DT#2021-9-1-12:00:00 起始时间
  xDone BOOL
  xBusy BOOL
  xErr BOOL
  eErr emPLCTimeErrorCode
  dtCurrTime DT
- CFC示例
- ST示例 RTC_inst0(EN_Rising := EnRTC , dtPresetDateAndTime := dtStartTime , xDone => xDone , xBusy => xBusy , xError => xErr , eError => eErr , dtDateAndTime => dtCurrTime );
- LD示例