Python 将时间戳转换为指定格式日期（一文讲透）

Python 将时间戳转换为指定格式日期：从零开始掌握时间处理

你有没有遇到过这样的情况？从 API 接口获取到一个时间数据，显示的是类似 1712345678 这样的数字，看起来像是一串随机码。但其实，这正是“时间戳”的表现形式。作为开发者，我们常常需要把这种“机器看得懂”的时间戳，转换成人类可读的日期格式，比如 2024-04-05 10:34:38。

这正是我们今天要讲的核心内容：Python 将时间戳转换为指定格式日期。它看似简单，但背后涉及的时间概念、时区处理、格式控制，都是实际开发中绕不开的基础技能。本文将带你一步步掌握这一能力，从最基础的用法到进阶技巧，手把手带你实战。

什么是时间戳？为什么需要转换？

时间戳（Timestamp）是计算机中记录时间的一种方式，它表示从1970年1月1日 00:00:00 UTC（也就是“Unix 纪元”）开始，到某个特定时刻所经过的秒数（或毫秒数）。这个数字是纯整数，机器处理起来非常高效，但对人来说完全无意义。

举个例子：

timestamp = 1712345678

这个数字代表的是 2024 年 4 月 5 日上午 10 点 34 分 38 秒（UTC+8 区）。但如果你直接打印这个数字，谁也看不出它代表什么。

因此，我们需要“翻译”这个时间戳，让它变成我们熟悉的日期时间格式。这正是 Python 将时间戳转换为指定格式日期 的核心任务。

使用 datetime 模块：最基础的转换方法

Python 内置的 datetime 模块是处理时间的核心工具。我们可以通过 datetime.fromtimestamp() 方法，将时间戳转换为本地时间的 datetime 对象。

基础用法示例

import datetime

timestamp = 1712345678

dt = datetime.datetime.fromtimestamp(timestamp)

print(dt)

代码注释：

• import datetime：导入 Python 内置的时间处理模块。
• datetime.fromtimestamp(timestamp)：将时间戳（秒为单位）转换为本地时区的 datetime 对象。
• print(dt)：直接输出 datetime 对象，默认格式为 YYYY-MM-DD HH:MM:SS。

这个方法简单直接，但输出的格式是固定的。如果想自定义格式，比如显示为 2024年04月05日 10时34分38秒，就需要用到 strftime 方法。

格式化输出：自定义日期时间格式

strftime（string format time）是 datetime 对象提供的强大方法，它允许你按照指定的格式将日期时间转换为字符串。

常用格式代码表

注意：格式代码必须使用百分号 % 开头，且大小写敏感。

实际案例：输出多种格式

import datetime

timestamp = 1712345678
dt = datetime.datetime.fromtimestamp(timestamp)

chinese_format = dt.strftime("%Y年%m月%d日 %H时%M分%S秒")
print(chinese_format)

english_format = dt.strftime("%B %d, %Y at %I:%M:%S %p")
print(english_format)

iso_format = dt.isoformat()
print(iso_format)

代码注释：

• strftime()：根据指定格式，将 datetime 对象转换为字符串。
• "%Y年%m月%d日 %H时%M分%S秒"：自定义中文格式，便于用户阅读。
• "%B %d, %Y at %I:%M:%S %p"：输出英文风格，%I 表示 12 小时制，%p 表示 AM/PM。
• isoformat()：返回符合 ISO 8601 标准的时间字符串，适合数据交换。

处理毫秒级时间戳：常见陷阱与解决方案

很多系统返回的时间戳是以毫秒为单位的，比如 1712345678123。如果直接传给 fromtimestamp()，会出错，因为该方法默认只接收秒级时间戳。

正确做法：除以 1000

import datetime

milli_timestamp = 1712345678123

second_timestamp = milli_timestamp / 1000

dt = datetime.datetime.fromtimestamp(second_timestamp)

print(dt)

代码注释：

• milli_timestamp / 1000：将毫秒值转换为秒值，因为 1 秒 = 1000 毫秒。
• datetime.fromtimestamp() 会自动处理毫秒部分，生成 microsecond 为 123000 的 datetime 对象。

⚠️ 注意：如果时间戳是微秒级（1000000 为单位），则需除以 1000000。

时区处理：本地时间 vs UTC 时间

时间戳本身是 UTC 时间的秒数，但 fromtimestamp() 默认会根据你的系统时区转换为“本地时间”。如果你需要精确控制时区，应该使用 datetime.utcfromtimestamp()。

UTC 与本地时间对比

import datetime

timestamp = 1712345678

local_dt = datetime.datetime.fromtimestamp(timestamp)
print("本地时间：", local_dt)

utc_dt = datetime.datetime.utcfromtimestamp(timestamp)
print("UTC 时间：", utc_dt)

代码注释：

• fromtimestamp()：返回本地时间，受系统时区影响。
• utcfromtimestamp()：返回 UTC 时间，不考虑本地时区。
• 在多时区应用中，推荐统一使用 UTC 时间存储，转换时再根据用户时区显示。

实战案例：日志文件时间解析

假设你有一个日志文件，每行包含一个毫秒级时间戳和操作描述：

1712345678123 | 用户登录成功
1712345700500 | 访问首页

我们来写一个脚本，将这些时间戳转换为可读格式：

import datetime

log_lines = [
    "1712345678123 | 用户登录成功",
    "1712345700500 | 访问首页"
]

for line in log_lines:
    # 按 | 分割
    parts = line.split(" | ")
    raw_timestamp = int(parts[0])
    
    # 转换为秒级时间戳
    second_timestamp = raw_timestamp / 1000
    
    # 转换为 datetime 对象
    dt = datetime.datetime.fromtimestamp(second_timestamp)
    
    # 格式化为中文时间
    formatted_time = dt.strftime("%Y-%m-%d %H:%M:%S")
    
    # 输出处理后的内容
    print(f"[{formatted_time}] {parts[1]}")

代码注释：

• split(" | ")：将日志行按分隔符拆分为时间戳和描述。
• int(parts[0])：将时间戳字符串转为整数。
• raw_timestamp / 1000：毫秒转秒。
• strftime()：统一输出为标准中文时间格式。
• 最终输出清晰、易读的日志时间。

总结：掌握 Python 将时间戳转换为指定格式日期

通过本文，我们系统学习了 Python 将时间戳转换为指定格式日期 的完整流程：

• 了解时间戳的本质：从 Unix 纪元开始的秒数。
• 掌握 fromtimestamp() 和 utcfromtimestamp() 的区别。
• 熟练使用 strftime() 自定义输出格式，满足不同场景需求。
• 正确处理毫秒级时间戳，避免数据错乱。
• 在真实项目中（如日志解析、API 数据处理）灵活应用。

这个技能虽然基础，却是几乎所有后端、数据分析、自动化脚本开发的必备项。当你看到时间戳变成“2024年04月05日 10时34分38秒”时，那种“机器语言翻译成功”的成就感，值得你花时间掌握。

记住：时间是数据的重要维度，而格式化是让数据“说话”的第一步。从今天起，别再让时间戳“沉默”了。