time.gmtime 将时间戳转换为UTC的struct_time对象,不传参数时使用当前时间,返回包含年、月、日、时、分、秒等字段的UTC时间结构,与localtime区别在于其基于UTC而非本地时区,常用于跨时区时间处理和日志记录。

time.gmtime 是 Python 中 time 模块的一个函数,用于将时间戳(timestamp)转换为协调世界时(UTC)的 struct_time 对象。
基本用法
调用 time.gmtime([secs]) 时,它会把一个时间戳(从 Unix 纪元开始的秒数,通常是 1970 年 1 月 1 日 00:00:00 UTC)转换成表示 UTC 时间的 struct_time 结构。如果不传参数或传入 None,则默认使用当前时间的时间戳。
示例代码:
import time <h1>当前时间的 UTC struct_time</h1><p>utc_time = time.gmtime() print(utc_time)</p>
输出类似:
time.struct_time(tm_year=2025, tm_mon=4, tm_mday=5, tm_hour=10, tm_min=30, tm_sec=0, tm_wday=5, tm_yday=95, tm_isdst=0)
返回值说明
返回的是一个 struct_time 类型的对象,包含以下字段:
立即学习“Python免费学习笔记(深入)”;
- tm_year:年份
- tm_mon:月份(1-12)
- tm_mday:日期(1-31)
- tm_hour:小时(0-23)
- tm_min:分钟(0-59)
- tm_sec:秒数(0-60,允许闰秒)
- tm_wday:星期几(0-6,0 表示周一)
- tm_yday:一年中的第几天(1-366)
- tm_isdst:是否为夏令时(UTC 下通常为 0)
与 localtime 的区别
time.gmtime 返回的是 UTC 时间,而 time.localtime 返回的是本地时区的时间。如果你需要显示用户所在地区的具体时间,应该用 localtime;如果要做跨时区统一处理或日志记录,常用 gmtime 或更推荐使用 datetime.timezone.utc 配合 datetime 模块。
实际用途
- 生成标准 UTC 时间记录
- 避免本地时区干扰的时间计算
- 和服务器、API 交互时保持时间一致
基本上就这些。不复杂但容易忽略细节,比如时区问题。











