mktime()函数将本地时间元组转换为Unix时间戳,需传入包含9个元素的元组或struct_time对象,自动按系统时区调整,常用于时间存储与计算,注意输入应为本地时间而非UTC以避免错误。

Python 中 mktime() 函数用于将本地时间的 struct_time 对象或包含 9 个元素的元组转换为 **Unix 时间戳**(即从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数)。它属于 time 模块,是时间处理中常用的方法之一。
mktime() 的基本用法
mktime() 接收一个表示本地时间的元组或 struct_time 对象,格式如下:
- tm_year:年份(如 2024)
- 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:是否启用夏令时(-1, 0, 1)
其中前 6 项是关键,后三项可由系统推算,但传入时需完整。
示例:
将 2024 年 4 月 5 日 10:30:00 转为时间戳:
import time构造本地时间元组
local_time_tuple = (2024, 4, 5, 10, 30, 0, 4, 96, -1)
立即学习“Python免费学习笔记(深入)”;
timestamp = time.mktime(local_time_tuple) print(timestamp) # 输出类似 1712303400.0
注意时区和本地时间
mktime() 假设输入的时间是本地时间,并根据系统的时区和夏令时规则自动调整。例如在中国(CST, UTC+8),同样的时间比 UTC 快 8 小时,所以计算出的时间戳会对应到 UTC 的更早时刻。
网奇.NET网络商城系统是基于.Net平台开发的免费商城系统。功能强大,操作方便,设置简便。无需任何设置,上传到支持asp.net的主机空间即可使用。系统特色功能:1、同时支持Access和SqlServer数据库;2、支持多语言、多模板3、可定制缺货处理功能4、支持附件销售功能5、支持会员组批发功能6、提供页面设计API函数7、支持预付款功能8、配送价格分地区按数学公式计算9、商品支持多类别,可
对比 calendar.timegm():它用于 UTC 时间元组转时间戳,不考虑本地时区。
对比示例:
import time import calendarlocal_tuple = (2024, 4, 5, 10, 30, 0, 4, 96, -1)
本地时间转时间戳(考虑时区)
local_ts = time.mktime(local_tuple)
UTC 时间转时间戳(不考虑时区)
utc_ts = calendar.timegm(local_tuple)
print("本地 mktime:", local_ts) print("UTC timegm:", utc_ts)
常见用途与注意事项
- 常用于将用户输入的年月日时分秒组合成时间戳,便于存储或计算时间差
- 输入必须是 本地时间,若传入 UTC 时间元组会导致结果错误
- tm_isdst 设为 -1 表示让系统自动判断是否启用夏令时;0 表示不启用;1 表示启用
- 如果时间超出范围或格式错误,可能抛出 OverflowError 或 ValueError
基本上就这些。mktime() 是把结构化本地时间变成时间戳的直接方式,理解它的时区假设是正确使用的关键。










