在Python标准库中,time模块是处理时间与日期的基础工具集,提供低级时间操作接口。与datetime模块侧重高精度、面向对象的时间建模不同,time模块更偏向于系统级时间获取、时间戳转换、程序延时等底层功能,是编写高性能时间敏感型应用(如日志记录、性能测试、定时任务)不可或缺的组件。
其核心设计哲学是:**简洁、高效、可移植**。所有函数均基于C语言库(如time.h、sys/time.h)实现,保证跨平台一致性,同时避免了额外依赖。从Python 1.4起time模块便作为内置模块存在,历经30余年演进,始终是Python时间生态的基石。
time模块操作的核心数据结构有三种:
1717020000.123456tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst三者关系可通过以下转换链建立:
时间戳 ↔ 时间元组 ↔ 格式化字符串
返回当前时间戳(float),精度取决于系统支持,通常为微秒级(10⁻⁶秒)。适用于记录事件发生时刻、计算时间差等。
⚠️ 注意:time.time()反映的是“墙上时间”(wall-clock time),受系统时间调整影响;若需避免系统时间回拨干扰,应使用time.perf_counter()。
time.localtime([secs]):将时间戳转换为本地时间元组;不传参则用当前时间戳。
time.gmtime([secs]):将时间戳转换为UTC时间元组;不传参则用当前时间戳。
time.mktime(t):将本地时间元组转换为时间戳(注意:输入必须是本地时间元组!)
time.mktime()与time.gmtime()的配合:实现UTC时间戳与本地时间的精确互转。
💡 实用技巧:time.mktime()在跨时区应用中易出错,推荐用calendar.timegm()处理UTC元组到时间戳的转换。
time.strftime(format[, t]):将时间元组按指定格式转换为字符串;t默认为当前本地时间元组。
time.strptime(string[, format]):将字符串按指定格式解析为时间元组。
| 格式符 | 含义 | 示例 | 备注 |
|---|---|---|---|
| %Y | 四位年份 | 2024 | 完整年份 |
| %y | 两位年份 | 24 | 00-99,00-68为2000-2068,69-99为1969-1999 |
| %m | 月份(01-12) | 05 | 补零 |
| %d | 日(01-31) | 30 | 补零 |
| %H | 24小时制(00-23) | 14 | 补零 |
| %I | 12小时制(01-12) | 02 | 补零,配合%p使用 |
| %M | 分钟(00-59) | 30 | 补零 |
| %S | 秒(00-59) | 05 | 补零 |
| %f | 微秒(000000-999999) | 123456 | 仅datetime支持,time.strftime不支持! |
| %z | UTC偏移 | +0800 | 需手动设置时区环境变量 |
| %Z | 时区名称 | CST | 依赖系统时区数据库 |
| %j | 年内第几天(001-366) | 151 | 补零 |
| %w | 星期(0-6,0=周日) | 4 | 注意:0是周日,非周一 |
| %A | 星期全名 | Thursday | 英文 |
| %a | 星期缩写 | Thu | 英文 |
| %B | 月份全名 | May | 英文 |
| %b/%h | 月份缩写 | May | 英文 |
| %p | AM/PM | PM | 依赖本地语言环境 |
| %c | 本地日期时间表示 | 05/30/24 14:30:05 | 格式因地区而异 |
| %x | 本地日期表示 | 05/30/24 | 格式因地区而异 |
| %X | 本地时间表示 | 14:30:05 | 格式因地区而异 |
| %% | 百分号本身 | % | 转义 |
💡 关键提示:
• %f在time模块中**不支持**(仅datetime支持),使用会引发ValueError
• %z/%Z在time.strftime中行为依赖系统,跨平台需谨慎
• 推荐使用ISO 8601标准格式(%Y-%m-%dT%H:%M:%S)提升兼容性
time.sleep(secs):暂停当前线程执行指定秒数(float),精度依赖系统调度器,通常为毫秒级。
💡 实际应用:
• API调用限速(避免触发频率限制)
• UI动画帧率控制
• 资源等待(如文件写入完成)
• 重试机制中的退避延迟
同步sleep阻塞整个线程;asyncio.sleep()是协作式调度,不阻塞事件循环,适合高并发场景。
对于高精度延时(微秒级),可结合循环与perf_counter()实现:
UTC(协调世界时)是全球标准时间基准,不受夏令时影响;本地时间是根据系统时区设置转换的本地化时间。
💡 注意:time.timezone为负值(表示东经),中国为-28800(即UTC+8)
time.daylight:非零值表示本地时区支持夏令时;time.altzone:夏令时期间的时区偏移(秒)。
⚠️ 陷阱:time模块不自动处理历史夏令时变更,跨年日期转换需谨慎
推荐方案!内置时区数据库,支持全球时区:
通过time.timezone和time.altzone手动计算偏移,易出错:
⚠️ 缺陷:无法处理历史时区变更、夏令时规则复杂(如美国各州不同)
| 函数 | 用途 | 精度 | 是否受系统时间调整影响 | 适用场景 |
|---|---|---|---|---|
| time.time() | 墙上时间 | 微秒级 | 是 | 记录事件绝对时刻 |
| time.perf_counter() | 高精度性能计数器 | 纳秒级 | 否 | 测量短时间间隔(推荐) |
| time.process_time() | 进程CPU时间 | 微秒级 | 否 | 测量代码实际CPU耗时 |
time.time()返回浮点数,但**小数部分并非总可靠**。在32位系统上,Python 3.7+使用双精度浮点,但Windows系统在Python 3.8前存在精度问题(仅毫秒级)。
错误:将UTC时间元组直接用于time.mktime()
错误:time.strftime("%Y-%m-%d %H:%M:%S.%f") # %f不支持!
A:让出当前线程的CPU时间片,允许其他线程运行。常用于循环中避免独占CPU,但不保证立即恢复执行。
A:
• 毫秒:int(time.time() * 1000)
• 微秒:int(time.time() * 1000000)
• 纳秒(Python 3.7+):time.time_ns()
A:
1. 检查format字符串与输入是否严格匹配
2. 确保格式符与数据类型一致(如%Y对应四位年份)
3. 使用try-except捕获ValueError并提示用户
4. 考虑用dateutil.parser.parse()(第三方库,更宽松)
A:POSIX标准规定time.timezone为UTC偏移的负值(东经为负)。中国时区为-28800(即UTC+8)。
A:
1. 统一存储UTC时间戳
2. 显示时转换为用户本地时区(用zoneinfo)
3. 避免直接存储本地时间(夏令时变更会导致混乱)