Python time.localtime() 详解

time.localtime() 是 Python 标准库 time 模块中的一个常用函数，用于将时间戳转换为本地时间的结构化时间对象（struct_time）。

基本语法

time.localtime([seconds])

• seconds（可选）：一个表示自 Unix 纪元（1970年1月1日 00:00:00 UTC）以来的秒数的时间戳。如果省略，默认使用当前时间。
• 返回值：一个 time.struct_time 对象，包含年、月、日、时、分、秒等字段。

返回值字段说明

struct_time 是一个包含 9 个元素的元组，可通过索引或属性名访问：

• tm_year：年（如 2026）
• tm_mon：月（1–12）
• tm_mday：日（1–31）
• tm_hour：小时（0–23）
• tm_min：分钟（0–59）
• tm_sec：秒（0–61，支持闰秒）
• tm_wday：星期（0 为周一，6 为周日）
• tm_yday：一年中的第几天（1–366）
• tm_isdst：是否夏令时（1 是，0 否，-1 未知）

代码示例

import time

local_time = time.localtime()
print(local_time)
# 输出示例：time.struct_time(tm_year=2026, tm_mon=1, tm_mday=7, tm_hour=6, tm_min=54, ...)

import time

t = time.localtime()
formatted = time.strftime("%Y-%m-%d %H:%M:%S", t)
print(formatted)
# 输出示例：2026-01-07 06:54:30

import time

timestamp = 1700000000  # 示例时间戳
local_time = time.localtime(timestamp)
print(time.strftime("%Y-%m-%d %H:%M:%S", local_time))
# 输出：2023-11-14 22:13:20（具体取决于时区）

实时演示（基于浏览器时间）

注意事项

• time.localtime() 返回的是本地时区的时间，与 time.gmtime()（UTC 时间）不同。
• 在多线程或高精度场景中，建议使用 datetime 模块替代。
• 该函数依赖系统时区设置，跨平台行为可能略有差异。