1. 引言
在 Python 编程中，处理时间和日期是常见的需求，无论是记录日志、定时任务、性能分析还是数据时间戳处理，都离不开时间模块。Python 内置的 time 模块提供了丰富的函数来处理时间相关的操作，它是标准库中最基础、最常用的时间模块之一。
本文将详细介绍 time 模块的核心功能，包括时间获取、格式化、休眠、性能计时等，并通过实际代码示例帮助你快速掌握其用法。
2. time 模块概述
time 模块主要提供了以下功能：
- 时间获取：获取当前时间戳、结构化时间等。
- 时间格式化：将时间在字符串、时间戳、结构化格式之间转换。
- 程序休眠：让程序暂停执行指定的秒数。
- 性能计时：测量代码段的执行时间。
- 时区处理：获取和设置时区信息（部分功能）。
3. 核心函数与用法
3.1 获取当前时间
time.time()
返回当前时间的时间戳（浮点数），表示自 1970 年 1 月 1 日 00:00:00（UTC）以来的秒数。
python
import time
timestamp = time.time()
print(f"当前时间戳: {timestamp}")
# 输出示例: 当前时间戳: 1745315368.123456time.localtime(secs)
将时间戳转换为本地时间的结构化时间（struct_time 对象）。若不传入参数，则使用当前时间。
python
local_time = time.localtime()
print(local_time)
# 输出: time.struct_time(tm_year=2026, tm_mon=8, tm_mday=22, tm_hour=15, tm_min=49, tm_sec=28, tm_wday=4, tm_yday=234, tm_isdst=0)
# 可以访问具体字段
print(f"年份: {local_time.tm_year}")
print(f"月份: {local_time.tm_mon}")
print(f"日期: {local_time.tm_mday}")time.gmtime(secs)
将时间戳转换为 UTC 时间的结构化时间。
python
utc_time = time.gmtime()
print(utc_time)3.2 时间格式化与解析
time.strftime(format, t)
将结构化时间（struct_time 或元组）格式化为字符串。
python
formatted = time.strftime("%Y-%m-%d %H:%M:%S", local_time)
print(formatted) # 输出: 2026-08-22 15:49:28
# 常用格式符：
# %Y: 四位年份
# %m: 月份（01-12）
# %d: 日期（01-31）
# %H: 小时（00-23）
# %M: 分钟（00-59）
# %S: 秒（00-59）
# %A: 星期全名
# %a: 星期缩写time.strptime(string, format)
将格式化的时间字符串解析为结构化时间。
python
time_str = "2026-08-22 15:49:28"
parsed_time = time.strptime(time_str, "%Y-%m-%d %H:%M:%S")
print(parsed_time)3.3 程序休眠
time.sleep(secs)
让当前线程暂停执行指定的秒数（可以是浮点数，表示更精确的时间）。
python
print("开始休眠...")
time.sleep(2.5) # 休眠 2.5 秒
print("休眠结束！")3.4 性能计时
time.perf_counter()
返回一个高精度的性能计数器的值（以秒为单位），用于测量短时间间隔。
python
start = time.perf_counter()
# 模拟耗时操作
time.sleep(0.1)
end = time.perf_counter()
print(f"操作耗时: {end - start:.6f} 秒")time.process_time()
返回当前进程的系统和用户 CPU 时间总和（以秒为单位），用于测量 CPU 时间。
python
start_cpu = time.process_time()
# 执行一些计算
sum(range(1000000))
end_cpu = time.process_time()
print(f"CPU 时间: {end_cpu - start_cpu:.6f} 秒")4. 时间戳与结构化时间转换
time 模块提供了在时间戳和结构化时间之间转换的函数：
time.mktime(t)：将本地时间的结构化时间转换为时间戳。time.gmtime([secs])：将时间戳转换为 UTC 结构化时间（已介绍）。time.localtime([secs])：将时间戳转换为本地结构化时间（已介绍）。
python
# 结构化时间 -> 时间戳
struct_time = time.localtime()
timestamp_from_struct = time.mktime(struct_time)
print(f"转换回的时间戳: {timestamp_from_struct}")
# 时间戳 -> 结构化时间（本地）
new_struct = time.localtime(timestamp_from_struct)
print(new_struct)5. 其他实用函数
time.ctime(secs)
将时间戳转换为可读的字符串格式。若不传入参数，则使用当前时间。
python
readable = time.ctime()
print(readable) # 输出: Fri Aug 22 15:49:28 2026time.asctime(t)
将结构化时间转换为可读的字符串格式。
python
asc_time = time.asctime(local_time)
print(asc_time) # 输出: Fri Aug 22 15:49:28 2026time.timezone
本地时区偏移量（秒，UTC 以西为正）。
python
print(f"本地时区偏移: {time.timezone} 秒")6. 实战示例
示例 1：计算函数执行时间
python
import time
def expensive_function():
total = 0
for i in range(1000000):
total += i
return total
start = time.perf_counter()
result = expensive_function()
end = time.perf_counter()
print(f"函数结果: {result}")
print(f"执行时间: {end - start:.4f} 秒")示例 2：生成带时间戳的日志
python
def log_message(level, message):
timestamp = time.strftime("%Y-%m-%d %H:%M:%S")
print(f"[{timestamp}] [{level}] {message}")
log_message("INFO", "程序启动成功")
time.sleep(1)
log_message("WARNING", "磁盘空间不足")示例 3：简单的倒计时
python
def countdown(seconds):
for i in range(seconds, 0, -1):
print(f"\r倒计时: {i} 秒", end="", flush=True)
time.sleep(1)
print("\r倒计时结束！")
countdown(5)7. 注意事项与最佳实践
- 时间戳精度 ：
time.time()返回的浮点数时间戳精度取决于系统，通常为微秒级。对于高精度计时，使用time.perf_counter()。 - 时区问题 ：
time模块的时区功能有限，对于复杂的时区处理，建议使用datetime模块配合pytz库。 time.sleep()阻塞：该函数会阻塞当前线程，在 GUI 或异步程序中需谨慎使用。- 性能计时选择 ：
- 测量墙上时钟时间（实际耗时）用
time.perf_counter()。 - 测量 CPU 时间（进程占用 CPU 的时间）用
time.process_time()。
- 测量墙上时钟时间（实际耗时）用
- 格式化字符串 ：
strftime和strptime的格式符需严格匹配，否则会抛出ValueError。
8. 总结
Python 的 time 模块是处理时间相关任务的基础工具，它提供了时间获取、格式化、休眠和计时等核心功能。掌握 time.time()、time.localtime()、time.strftime()、time.sleep() 和 time.perf_counter() 等常用函数，能够满足大多数日常开发需求。
对于更复杂的日期时间操作（如时区转换、日期加减、工作日计算等），可以结合 datetime 模块使用。time 模块与 datetime 模块相辅相成，共同构成了 Python 强大的时间处理能力。
希望本文能帮助你更好地理解和使用 Python 的 time 模块！