clock_systohc 函数

标头: #include <applibs/rtc.h>

将实时时钟 (RTC) 与当前系统时间同步。 RTC 仅以 UTC/GMT 格式存储时间。 因此,仅当本地时区不是 GMT 时,才需要从本地时间转换。

int clock_systohc(void);

错误

如果遇到错误并设置为 errno 错误值,则返回 -1。

  • EACCES:调用方没有 SystemTime 功能。

  • EBUSY:RTC 设备正在使用中,无法打开。 调用方应定期重试,直到成功。

还可以指定任何其他 errno 错误;此类错误不是确定性的,并且可能不会通过系统更新保留相同的行为。

返回值

如果成功,则返回 0,如果失败,则返回 -1,在这种情况下 errno ,将 设置为错误值。

应用程序清单要求

此函数需要 应用程序清单中的 SystemTime 功能。

概念和示例