在 Python 开发中，**time 模块是处理时间获取、时间格式化、时间计算与程序延迟的基础工具**。无论是编写日志系统、调度任务、性能分析，还是与外部系统进行时间对齐，time 模块几乎都会被用到。**它以接近操作系统底层时间的方式工作，强调“时间戳”和“结构化时间”之间的转换**，与 datetime 模块形成互补关系。理解 time 的常用函数，不仅能提升代码的可读性，也能避免在时间计算、跨平台兼容性和性能方面出现隐性问题。

---

## 一、time 模块概述与使用场景

time 模块是 Python 标准库的一部分，主要提供**访问系统时间、时间戳与休眠控制**等能力。它的设计初衷是贴近 C 语言的 time.h，因此在接口风格上偏向过程式，而不是面向对象。这也决定了 time 模块在底层时间操作、性能测试、简单时间换算方面具有明显优势。

在实际开发中，time 模块常见于以下场景：**获取当前时间戳用于日志排序、计算代码执行耗时、控制程序暂停（sleep）、进行简单的时间格式化输出**。相比 datetime，time 更适合做“短平快”的时间处理任务，尤其是在脚本工具、系统运维程序和轻量级服务中。需要注意的是，time 模块中的时间通常依赖系统时区设置，因此在跨服务器部署时要格外关注时区一致性问题。

---

## 二、time.time：获取当前时间戳的核心函数

**time.time() 是 time 模块中最常用、也是最基础的函数之一**，它返回自 Unix 纪元（1970-01-01 00:00:00 UTC）以来经过的秒数，类型为浮点数。这个值通常被称为“时间戳”，是许多系统中通用的时间表示方式。

时间戳的最大优势在于**易于比较和存储**。例如，在日志系统中，只需比较两个时间戳的大小即可判断事件发生顺序；在性能分析中，通过记录开始和结束时间戳即可计算耗时。需要注意的是，time.time() 返回的是“墙上时间（wall time）”，它可能会受到系统时间被手动修改或 NTP 同步的影响。因此，在对时间连续性要求极高的场景（如性能基准测试）中，通常会使用更稳定的计时函数。

---

## 三、time.sleep：程序延迟与节流控制

**time.sleep(seconds)** 用于让当前线程暂停执行指定的秒数，是实现延迟、轮询和简单调度逻辑的关键函数。参数 seconds 可以是整数或浮点数，这使得 sleep 可以支持亚秒级的精度控制。

在实际应用中，time.sleep 常被用于**控制请求频率、防止 CPU 空转、模拟耗时操作**等场景。例如，在爬虫或接口轮询程序中，通过 sleep 控制访问节奏，可以降低对目标系统的压力。需要明确的是，time.sleep 会阻塞当前线程，这在多线程或异步程序中可能带来副作用。因此，在并发场景下，通常会结合 threading、asyncio 等机制使用，而不是单纯依赖 time.sleep。

---

## 四、time.localtime 与 time.gmtime：时间戳到结构化时间

time.localtime() 和 time.gmtime() 用于将时间戳转换为结构化时间（struct_time）。**两者的核心区别在于是否考虑本地时区**：localtime 使用本地时区，gmtime 使用 UTC 时间。

struct_time 是一个包含年、月、日、时、分、秒等字段的元组结构，非常适合做时间字段级别的访问和判断。例如，在日志分析中，可以直接从 struct_time 中取出 tm_hour 判断是否发生在业务高峰期。需要注意的是，如果不传参数，这两个函数默认使用当前时间戳。对于需要明确区分“本地时间”和“全球统一时间”的系统，合理选择 localtime 与 gmtime 至关重要。

---

## 五、time.strftime 与 time.strptime：时间格式化与解析

**time.strftime(format, t)** 用于将结构化时间转换为字符串，而 **time.strptime(string, format)** 则执行反向操作，将字符串解析为 struct_time。这一对函数在日志输出、报表生成和配置解析中极为常见。

strftime 的优势在于灵活的格式控制，例如通过 %Y-%m-%d %H:%M:%S 输出人类可读的时间格式。strptime 则常用于解析外部输入，如配置文件中的时间字符串或用户输入的日期。需要注意的是，strptime 对格式要求非常严格，一旦字符串与格式不匹配就会抛出异常，因此在生产环境中通常需要配合异常处理使用。

---

## 六、time.perf_counter 与 time.process_time：高精度计时

在性能测试和代码优化中，**time.perf_counter() 和 time.process_time() 是比 time.time 更可靠的计时工具**。perf_counter 提供一个单调递增的高精度计时器，适合测量短时间间隔；process_time 则只计算 CPU 执行时间，不包含休眠和 I/O 等等待时间。

这两个函数的共同特点是**不受系统时间调整影响**，因此在基准测试中更具稳定性。例如，在比较两种算法的执行效率时，使用 perf_counter 可以获得更准确的耗时差异。需要强调的是，这类函数的返回值仅用于时间差计算，本身并不具备现实时间含义，不应被当作“当前时间”使用。

---

## 七、time 模块常用函数对比表

下表对 Python time 模块中常用函数进行了定性对比，帮助快速理解各函数的适用场景：

| 函数名 | 返回类型 | 是否受系统时间影响 | 典型用途 |
|------|--------|----------------|--------|
| time.time | float | 是 | 获取当前时间戳、日志记录 |
| time.sleep | None | 否 | 程序延迟、节流控制 |
| time.localtime | struct_time | 是 | 本地时间解析 |
| time.gmtime | struct_time | 否（UTC） | 全球统一时间处理 |
| time.strftime | str | 依赖输入 | 时间格式化输出 |
| time.strptime | struct_time | 否 | 时间字符串解析 |
| time.perf_counter | float | 否 | 性能测试 |
| time.process_time | float | 否 | CPU 时间统计 |

通过该表可以看出，**time 模块函数大致分为“现实时间处理”和“性能计时”两大类**，在选择时应根据业务目标进行区分。

---

## 八、time 与 datetime 的差异与协同使用

虽然 time 模块功能丰富，但在复杂业务中，它通常不会单独使用。**datetime 模块提供了更强的面向对象能力和时区处理能力**，而 time 更偏向底层和性能导向。在实践中，常见模式是：使用 time.time 获取时间戳用于存储或比较，再通过 datetime 将其转换为更友好的时间对象进行展示和计算。

需要注意的是，time 模块对时区的支持相对有限，主要依赖系统配置；而 datetime（结合 zoneinfo）可以更精确地处理跨时区问题。因此，在国际化应用或涉及夏令时的系统中，time 更多承担“时间戳工具”的角色，而不是完整的时间解决方案。

---

## 九、使用 time 模块的常见误区与最佳实践

在使用 time 模块时，开发者容易陷入几个误区。**第一，将 time.time 用于高精度性能测试**，这可能因系统时间调整导致结果异常；**第二，忽视本地时区差异，错误使用 localtime 与 gmtime**；**第三，在并发程序中过度使用 time.sleep，导致线程阻塞**。

最佳实践包括：性能测试优先使用 perf_counter；涉及全球时间统一的场景使用 UTC；在需要复杂时间运算时引入 datetime；在日志和存储层尽量使用时间戳，在展示层再格式化。这些经验可以显著提升程序的健壮性和可维护性。

---

## 十、总结与未来趋势

总体来看，**Python 的 time 模块在“轻量级时间处理”和“高精度计时”方面依然不可替代**。尽管 datetime 和第三方库在功能上更为强大，但 time 以其简洁、稳定和贴近系统的特性，仍然是 Python 时间体系中的基石。随着 Python 对时区和时间精度支持的持续完善，未来更可能出现的是 time 与 datetime 的进一步协同，而不是彼此取代。理解并正确使用 time 的常用函数，是每一位 Python 开发者的基础能力。

参考与资料来源  
Python 官方文档：The time Module，Python Software Foundation，2024  
Python 官方文档：Measuring Execution Time，Python Software Foundation，2023

可以通过调用time.time()函数来获取当前时间的时间戳，即自1970年1月1日以来经过的秒数，返回值是一个浮点数。

使用time.time()获取当前时间戳

在Python中，怎样使用time模块获取当前的时间戳？

如何获取当前时间戳？

先使用time.localtime(timestamp)将时间戳转换为时间元组，再用time.strftime(format, time_tuple)将时间元组格式化为字符串，其中format可以自定义时间显示格式。

使用time.localtime()和time.strftime()进行格式转换

怎么用time模块将一个时间戳转换为人类易读的年-月-日 时:分:秒格式？

如何将时间戳转换为可读的时间格式？

调用time.sleep(seconds)函数可以让程序暂停执行指定的秒数，参数seconds可以是整数或浮点数，表示暂停的时间长度。

通过time.sleep(seconds)实现程序暂停

怎么使用time模块让Python程序暂停运行一段时间？

time模块中如何暂停程序执行？

PingCodeDocs

本文系统梳理了 Python 中 time 模块的常用函数及其适用场景，重点解释了 time.time、time.sleep、localtime、strftime 以及高精度计时函数的差异与用途。通过对比表和实践分析，明确了 time 模块在时间戳处理、程序延迟和性能测试中的核心价值，同时指出了与 datetime 模块协同使用的最佳方式。文章还总结了常见误区与最佳实践，为开发者在真实项目中合理选择时间处理方案提供了清晰参考。

python中time的常用函数