该模块实现了相应CPython模块的子集,如下所述。有关更多信息,请参阅原始CPython文档: time.
utime模块提供获取当前时间和日期,测量时间间隔和延迟的功能。
时间纪元: Unix移植版本使用标准为1970-01-01 00:00:00 UTC的POSIX系统时代。但是,嵌入式移植版本使用的是2000-01-01 00:00:00 UTC的纪元。
维护实际日历日期/时间: 这需要实时时钟(RTC)。在具有底层OS(包括一些RTOS)的系统上,RTC可能是隐含的。设置和维护实际日历时间是OS / RTOS的责任,并且在MicroPython之外完成,它只使用OS API来查询日期/时间。在裸机移植上,系统时间依赖于machine.RTC()对象。可以使用machine.RTC()。datetime(tuple)函数设置当前日历时间,并通过以下方式维护:
通过备用电池(可能是特定电路板的附加可选组件)。
使用联网时间协议(需要由移植/用户设置)。
每次上电时由用户手动设置(许多电路板在硬复位时保持RTC时间,但有些可能需要在这种情况下再次设置)。
如果未使用系统/ MicroPython RTC维护实际日历时间,则低于此要求参考当前绝对时间的函数可能与预期不符。
函数
utime.localtime([secs])
将自纪元(见上文)以秒为单位的时间转换为8元组,其中包含:(年,月,日,小时,分钟,秒,工作日,晚期)如果未提供秒数或无,则为当前时间来自RTC使用。
年份包括世纪(例如2014年)。
月是1-12
mday是1-31
小时是0-23
分钟是0-59
秒是0-59
周一至周日的工作日为0-6
yearday是1-366
utime.mktime()
这是本地时间的反函数。它的参数是一个完整的8元组,表示按当地时间表示的时间。它返回一个整数,它是自2000年1月1日以来的秒数。
utime.sleep(seconds)
睡眠给定的秒数。有些电路板可能会接受秒作为浮点数来休眠几秒钟。请注意,其他板可能不接受浮点参数,因为与它们的兼容性使用 sleep_ms() 和 sleep_us() 函数。