Python时间处理核心模块详解
Python时间处理核心模块详解
在Python开发中,精确的时间操作是许多应用场景的基础,如日志记录、定时任务、性能监控等。标准库中的time模块提供了对时间戳、本地时间、格式化输出以及程序延时等功能的底层支持。本文将系统讲解该模块的核心函数及其实际用法。
标准库简介与导入方式
Python标准库无需额外安装,随解释器一同发布。可通过以下代码查看其安装路径:
import sys
print(sys.exec_prefix)
标准库位于Python安装目录下的Lib文件夹中。使用time模块前需先导入,常见方式包括:
import time:导入整个模块from time import sleep:仅导入指定函数from time import *:导入所有公开成员(不推荐用于生产环境)import time as tm:为模块设置别名以简化调用
当执行import module_name时,Python按如下顺序搜索模块:
- 当前脚本所在目录
- 标准库路径(
Lib/) - 第三方包路径(
site-packages/)
若未找到对应模块,则抛出ModuleNotFoundError异常。
获取时间戳
时间戳(Timestamp)表示自1970年1月1日00:00:00 UTC以来经过的秒数,常用于记录事件发生的时间点或计算程序运行耗时。
import time
timestamp = time.time()
print(f"当前时间戳:{timestamp}")
# 示例输出:1752137285.4044664
利用时间戳可测量代码段执行时间:
start_time = time.time()
count = 0
while count < 100_000_000:
count += 1
end_time = time.time()
duration = end_time - start_time
print(f"循环耗时:{duration:.4f} 秒")
I/O操作对性能的影响
频繁的I/O操作会显著影响程序性能。例如,在循环中加入print()语句会导致大量系统调用,从而大幅增加执行时间:
# 包含print的循环
start = time.time()
for i in range(1_000_000):
print(i) # 每次输出都会触发I/O
end = time.time()
print(f"I/O密集型耗时:{end - start:.2f} 秒")
相比之下,将数据写入文件比屏幕输出更高效:
with open('output.txt', 'w') as f:
start = time.time()
for i in range(1_000_000):
f.write(f"{i}\n")
end = time.time()
print(f"文件写入耗时:{end - start:.2f} 秒")
获取结构化时间
localtime() —— 获取本地时间
time.localtime([secs])返回一个struct_time对象,包含年、月、日、时、分、秒等字段。若未传参,则返回当前本地时间。
local_t = time.localtime()
print(local_t)
# 输出示例:
# time.struct_time(tm_year=2025, tm_mon=7, tm_mday=10, tm_hour=19, tm_min=35, tm_sec=53,
# tm_wday=3, tm_yday=191, tm_isdst=0)
# 转换特定时间戳
converted = time.localtime(1622874693.666)
print(converted.tm_year, converted.tm_mon, converted.tm_mday) # 2021 6 5
gmtime() —— 获取UTC时间
time.gmtime([secs])返回世界协调时间(UTC),适用于跨时区应用的时间统一处理。
utc_time = time.gmtime()
print(utc_time)
# 输出示例:
# time.struct_time(tm_year=2025, tm_mon=7, tm_mday=10, tm_hour=11, tm_min=40, tm_sec=51,
# tm_wday=3, tm_yday=191, tm_isdst=0)
ctime() —— 获取可读字符串时间
time.ctime([secs])返回C风格的时间字符串,便于日志打印。
readable_time = time.ctime()
print(readable_time)
# 输出示例:Thu Jul 10 19:44:18 2025
时间格式转换
mktime() —— 结构化时间转时间戳
time.mktime(t)将struct_time对象转换回浮点型时间戳,常用于时间计算。
now_struct = time.localtime()
now_timestamp = time.mktime(now_struct)
print(now_timestamp) # 如:1752148652.0
strftime() —— 格式化时间输出
time.strftime(format, t)根据指定格式生成时间字符串。常用格式符如下:
| 格式符 | 含义 | 取值范围/示例 |
|---|---|---|
| %Y | 四位年份 | 1900–9999 |
| %m | 月份 | 01–12 |
| %d | 日期 | 01–31 |
| %H | 小时(24制) | 00–23 |
| %M | 分钟 | 00–59 |
| %S | 秒 | 00–59 |
| %A | 完整星期名 | Monday–Sunday |
| %B | 完整月份名 | January–December |
formatted = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
print(formatted) # 2025-07-10 20:05:28
strptime() —— 字符串解析为结构化时间
time.strptime(string, format)将格式化字符串解析为struct_time对象,是strftime()的逆操作。
date_str = "2021-09-30"
parsed_time = time.strptime(date_str, "%Y-%m-%d")
print(parsed_time)
# 输出:
# time.struct_time(tm_year=2021, tm_mon=9, tm_mday=30, tm_hour=0, tm_min=0, tm_sec=0,
# tm_wday=3, tm_yday=273, tm_isdst=-1)
程序休眠控制
time.sleep(seconds)使程序暂停指定秒数,参数可为整数或浮点数,适用于延时执行、限流、轮询等场景。
print("开始等待...")
time.sleep(3.5) # 暂停3.5秒
print("3.5秒后继续执行")
