2025年物联网AI MicroPython学习之语法 utime时间

科技前沿 • 2025-02-16 18:26 • 阅读 40

大家好，我是讯享网，很高兴认识大家。

学物联网，来万物简单IoT物联网！！
讯享网

utime 介绍

utime 模块用于获取当前时间和日期、测量时间间隔和延迟。

接口说明

localtime - 格式化时间戳

函数原型：utime.localtime([secs])
参数说明：

参数	类型	必选参数？	说明
secs	int	否	要转换的秒数

返回值：
该函数用来将一个以秒表示的时间转换为包含年、月、日、时、分、秒、星期、一年中第几天的元组，如果没有给定参数sec，则获取当前时值。返回值形式如下：

(year, month, mday, hour, minute, second, weekday, yearday)

year ：年份，int型
month ：月份，1~12，int型
mday ：日，当月几号，1~31，int型
hour ：小时，0~23，int型
minute ：分钟，0~59，int型
second ：秒，0~59，int型
weekday ：星期几，周一到周日是0~6，int型
yearday ：一年中的第多少天，int型
示例：

>>> utime.localtime() (2021, 11, 22, 16, 52, 34, 0, 326) >>> utime.localtime() (2004, 5, 26, 23, 43, 13, 2, 147)

讯享网

mktime - 反向格式化时间戳

函数原型：utime.mktime(date)
函数功能：
该函数作用与locatime()相反，它将一个存放在元组中的时间转换为以秒计的时间戳。
参数说明：

参数	类型	必选参数？	说明
secs	int	否	要转换的秒数

返回值：
返回date对应的秒数
示例：

讯享网>>> date = (2021, 11, 2, 14, 54, 42, 1, 0) >>> utime.mktime(date)

sleep - 秒级别休眠

函数原型：utime.sleep(seconds)
参数说明：

参数	类型	必选参数？	说明
seconds	int	是	休眠的目标秒数

注意：调用sleep()会导致程序处于阻塞状态。

sleep_ms - 毫秒级别休眠

函数原型：utime.sleep_ms(ms)
参数说明：

参数	类型	必选参数？	说明
ms	int	是	休眠的目标毫秒数

注意：调用sleep_ms()会导致程序处于阻塞状态。

sleep_us - 微妙级别休眠

函数原型：utime.sleep_us(us)
参数说明：

参数	类型	必选参数？	说明
us	int	是	休眠的目标微妙数

注意：调用sleep_us()会导致程序处于阻塞状态。

ticks_ms - 获取系统毫秒计数器

函数原型：utime.ticks_ms()
函数说明：
返回系统的毫秒计数器，在某些值后会重新计数(未指定)。计数值本身无特定意义，只适合用在 ticks_diff()函数中。

ticks_us - 获取系统微妙计数器

函数原型：utime.ticks_us()

和ticks_ms()类似，只是返回微秒计数器。

ticks_cpu - 高精度计数器

函数原型：utime.ticks_cpu()
函数功能：
和 ticks_ms/ticks_us 类似，具有更高精度 (使用 CPU 时钟)。

ticks_diff - 计算时间差

函数原型：utime.ticks_diff(new_ticks, early_ticks)
函数功能：
计算两次调用 ticks_ms()， ticks_us()，或 ticks_cpu()之间的时间差。因为这些函数的计数值可能会回环，不能直接相减，需要使用 ticks_diff() 函数。early_ticks时间需要在new_ticks时间之前，否则结果无法确定。这个函数不能计算很长的时间的差值(因为 ticks_*()函数会回绕，回绕周期一般不长)。通常用法是在带超时的轮询事件中调用。
示例：

cnt = 0 t1 = utime.ticks_us() while (utime.ticks_diff(utime.ticks_us(), t1) < 100): cnt += 1

time - 返回自纪元以来的秒数

函数原型：utime.time()
返回值：
返回自纪元以来的秒数。如果需要更高的精度，请使用 ticks_ms()和ticks_us()函数，如果需要日历时间，则直接调用localtime()。