SysTimeRtcSetTimezone

功能描述

此功能用于设置指定的时区设置。

时区设置使用结构 TimezoneInformation 来指定,并将存储在控制器的文件系统中。

UTC 时间戳转换为本地时间戳时,应考虑时区设置,反之亦然。

时区设置由以下转换函数来考虑:

  • SysTimeRtcConvertLocalToUtc

  • SysTimeRtcConvertUtcToLocal

  • SysTimeRtcConvertLocalToHighRes

  • SysTimeRtcConvertHighResToLocal

此外,当使用参数 RealTimeClock RealTimeClockSetRealTimeClock时,也会使用时区设置,这些参数在 LMC PacDrive 控制器上提供。

参数 RealTimeClock 提供基于控制器的 RTC 和时区信息计算得到的本地时间。

通过参数 SetRealTimeClock,可设置控制器的RTC,从而在设置 RTC 之前,根据时区设置将指定值转换为 UTC 值。

注: 函数 SysTimeRtcSetTimezone 的执行可能需要数百毫秒的时间。在将 TimezoneInformation 参数存储到控制器中的配置文件时,会导致执行时间增加。

为了帮助避免在执行此函数时妨碍其他任务,请实施以下其中一项措施:

  • 使用 AsyncManager提供的异步机制,将函数调用外包给外部任务。

  • 在具有适当任务配置的单独任务中执行函数调用。

图形表示形式

I/O 变量描述

输入/输出

类型

描述

pTimezone

TimezoneInformation

要为控制器设置的时区设置。

输出

类型

描述

SysTimeRtcSetTimezone

UDINT

运行时系统错误代码(请参阅 CmpErrors.library):

0 = 未检测到错误