目录Python time 模块完整使用说明一、导入模块二、核心概念三、常用函数详解1. time.time () 获取当前时间戳2. time.sleep (sec) 延时等待3. time.localtime ([timestamp]) 时间戳→本地结构化时间4. time.gmtime ([timestamp]) 时间戳→UTC 世界标准时间5. time.mktime (struct_time) 结构化时间→时间戳6. time.asctime ([struct_time]) 结构化时间→简易英文时间字符串7. time.ctime ([timestamp]) 时间戳→简易英文时间字符串8. time.strftime (format, struct_time) 格式化时间最常用常用格式化符号9. time.strptime (time_str, format) 时间字符串→结构化时间四、时间互转完整流程示例案例 1时间戳 ↔ 格式化字符串案例 2计算代码运行耗时五、高精度计时time.perf_counter ()六、补充函数七、常见报错与注意事项八、毫秒、时间戳快捷写法Python time 模块完整使用说明一、导入模块python运行import timetime 模块底层调用操作系统时间接口主要处理时间戳、结构化时间、格式化时间、延时四类功能。二、核心概念时间戳timestamp浮点数单位秒从1970-01-01 00:00:00 UTC纪元时间到当前的总秒数。struct_time 结构化时间元组格式(年,月,日,时,分,秒,星期,年中天数,夏令时)索引对应 | 下标 | 含义 | |----|----| |0|4 位年份 | |1 | 月份 1~12| |2 | 日期 1~31| |3 | 小时 0~23| |4 | 分钟 0~59| |5 | 秒 0~61闰秒| |6 | 星期 0 周一6 周日 | |7 | 年内第几天 1~366| |8 | 夏令时标记 -1/0/1|三、常用函数详解1. time.time () 获取当前时间戳python运行t time.time() print(t) # 输出 17xxxxxx.123456用途计算代码运行耗时、存储时间标记。2. time.sleep (sec) 延时等待python运行time.sleep(2) # 暂停2秒支持浮点数 time.sleep(0.5) 延时0.5秒3. time.localtime ([timestamp]) 时间戳→本地结构化时间不传参数默认转换当前时间戳python运行# 当前本地时间 local time.localtime() print(local) # 指定时间戳转本地时间 local2 time.localtime(1700000000)4. time.gmtime ([timestamp]) 时间戳→UTC 世界标准时间python运行utc time.gmtime()5. time.mktime (struct_time) 结构化时间→时间戳和 localtime 互逆python运行st time.localtime() ts time.mktime(st) print(ts)6. time.asctime ([struct_time]) 结构化时间→简易英文时间字符串python运行s time.asctime(time.localtime()) print(s) # Tue Jul 14 15:30:20 20267. time.ctime ([timestamp]) 时间戳→简易英文时间字符串等价于asctime(localtime(ts))python运行print(time.ctime()) print(time.ctime(1700000000))8. time.strftime (format, struct_time) 格式化时间最常用把 struct_time 转为自定义格式字符串常用格式化符号表格符号说明示例%Y4 位完整年份2026%m两位月份 01~1207%d两位日期 01~3114%H24 小时制 00~2315%M分钟 00~5925%S秒 00~5930%w星期 0 周日1 周一2%A完整星期英文Tuesday%B完整月份英文July%X时分秒本地格式15:25:30%x年月日本地格式07/14/26示例python运行# 当前时间格式化 now time.localtime() str_t time.strftime(%Y-%m-%d %H:%M:%S, now) print(str_t) # 2026-07-14 15:30:009. time.strptime (time_str, format) 时间字符串→结构化时间strftime 反向操作必须严格匹配格式python运行time_str 2026-07-14 15:30:00 st time.strptime(time_str, %Y-%m-%d %H:%M:%S) print(st) # 再转时间戳 ts time.mktime(st)四、时间互转完整流程示例案例 1时间戳 ↔ 格式化字符串python运行import time # 1. 时间戳 → 格式化字符串 ts time.time() st time.localtime(ts) date_str time.strftime(%Y-%m-%d %H:%M:%S, st) print(date_str) # 2. 格式化字符串 → 时间戳 text 2026-07-14 10:20:00 struct time.strptime(text, %Y-%m-%d %H:%M:%S) new_ts time.mktime(struct) print(new_ts)案例 2计算代码运行耗时python运行import time start time.time() # 测试代码 for i in range(1000000): pass end time.time() cost end - start print(f运行耗时{cost:.4f} 秒)五、高精度计时time.perf_counter ()time.time()受系统时间修改影响高精度计时推荐python运行start time.perf_counter() time.sleep(0.3) end time.perf_counter() print(end - start)适用算法性能测试、短耗时计算。六、补充函数time.process_time()仅统计CPU 占用时间sleep 休眠不计入time.timezone本地时区与 UTC 时差秒time.tzname本地时区名称二元组标准时间 / 夏令时七、常见报错与注意事项strptime格式不匹配 → ValueError 字符串和格式符号必须一一对应少空格、分隔符不一致都会报错。时间戳超出范围 Windows 系统纪元时间限制过小 / 过大时间戳会报错。本地时间 vs UTC 存储服务器日志建议统一用 UTCgmtime避免时区混乱。浮点数精度 time.time () 小数部分是微秒级如需毫秒可int(time.time() * 1000)。八、毫秒、时间戳快捷写法python运行# 当前毫秒时间戳 ms int(time.time() * 1000) print(ms) # 当前秒级时间戳 sec int(time.time()) print(sec)