Python时间日期处理代码片段:datetime格式化与时间戳转换

小鹿同学
小鹿同学
发布时间:2026-11-17 | 7人浏览过
原创

详细讲解Python中datetime对象的字符串格式化与解析、Unix时间戳双向转换代码片段,包含时区陷阱排查与高频避坑指南。

在日常 Python 开发中,时间日期处理主要依赖内置的 datetime 模块。高频场景集中在两大环节:一是将时间对象与可读字符串相互转换(格式化与解析),二是将时间对象与 Unix 时间戳相互转换。本文给出即开即用的标准代码片段,剖析关键参数、时区差异与核心避坑点。

Python时间日期处理代码片段:datetime格式化与时间戳转换
图 1:Python 时间日期对象核心转换路径拓扑

一、datetime 与字符串的互转(格式化与解析)

在数据输入输出、日志记录及接口通信中,字符串是最常见的时间载体。将 datetime 对象转换为指定格式字符串使用 strftime 方法(String Format Time),而将字符串解析为 datetime 对象则使用 strptime 类方法(String Parse Time)。

1. 获取当前时间与标准格式化(strftime)

调用 strftime(format) 可以将时间对象按指定的占位符排版成字符串。

from datetime import datetime

# 获取当前本地时间
now = datetime.now()

# 常用格式 1:标准日期时间(年-月-日 时:分:秒)
str_standard = now.strftime("%Y-%m-%d %H:%M:%S")
print("标准格式:", str_standard)
# 示例输出: 标准格式: 2026-10-16 15:30:00

# 常用格式 2:仅日期
str_date = now.strftime("%Y-%m-%d")
print("日期格式:", str_date)
# 示例输出: 日期格式: 2026-10-16

# 常用格式 3:紧凑型(常用于文件命名或流水号)
str_compact = now.strftime("%Y%m%d_%H%M%S")
print("紧凑格式:", str_compact)
# 示例输出: 紧凑格式: 20261016_153000

2. 字符串解析为 datetime 对象(strptime)

使用 datetime.strptime(date_string, format) 时,格式字符串的占位符与标点符号必须与输入字符串逐字符严格对齐,否则将抛出 ValueError。

from datetime import datetime

time_str = "2026-10-16 15:30:00"

# 按照给定的模式解析字符串
dt_obj = datetime.strptime(time_str, "%Y-%m-%d %H:%M:%S")

print("解析结果类型:", type(dt_obj))
print("年:", dt_obj.year, "月:", dt_obj.month, "日:", dt_obj.day)
print("时:", dt_obj.hour, "分:", dt_obj.minute, "秒:", dt_obj.second)
# 示例输出:
# 解析结果类型: <class 'datetime.datetime'>
# 年: 2026 月: 10 日: 16
# 时: 15 分: 30 秒: 0
占位符 含义说明 有效范围 / 示例
%Y 四位完整年份(小写 %y 为两位年份) 2026
%m 两位月份(带前导零) 01 - 12
%d 两位月份中的日期(带前导零) 01 - 31
%H 24 小时制小时(小写 %I 为 12 小时制) 00 - 23
%M 两位分钟数(注意与月份小写 %m 区分) 00 - 59
%S 两位秒数 00 - 59
%f 微秒(6位数字) 000000 - 999999
Python时间日期处理代码片段:datetime格式化与时间戳转换
图 2:字符串解析 (strptime) 与格式化 (strftime) 对应步骤

3. ISO 8601 标准格式简化解析(Python 3.7+)

若遇到符合 ISO 8601 标准的时间格式(例如 2026-10-16T15:30:00),无需手动编写冗长的占位符,直接使用 fromisoformat() 与 isoformat() 即可:

from datetime import datetime

# 标准输出 ISO 格式
dt = datetime(2026, 10, 16, 15, 30, 0)
iso_str = dt.isoformat()
print("ISO 格式:", iso_str)
# 示例输出: ISO 格式: 2026-10-16T15:30:00

# 直接逆向解析 ISO 字符串
parsed_dt = datetime.fromisoformat("2026-10-16T15:30:00")
print("逆向解析结果:", parsed_dt)
# 示例输出: 逆向解析结果: 2026-10-16 15:30:00

二、datetime 与 Unix 时间戳的互转

Unix 时间戳定义为自协调世界时(UTC)1970 年 1 月 1 日 00:00:00 起所流逝的秒数。在 Python 中,timestamp() 方法返回的是浮点数(秒级,小数部分表示微秒)。

1. datetime 转时间戳(dt.timestamp)

直接调用实例的 .timestamp() 方法:

from datetime import datetime

dt = datetime(2026, 10, 16, 15, 30, 0)

# 获取秒级时间戳(浮点数)
ts_float = dt.timestamp()
print("秒级浮点时间戳:", ts_float)
# 示例输出: 秒级浮点时间戳: 1792135800.0

# 转换为秒级整数时间戳(向下取整)
ts_sec = int(ts_float)
print("秒级整数时间戳:", ts_sec)
# 示例输出: 秒级整数时间戳: 1792135800

# 转换为常见接口要求的 13 位毫秒级时间戳
ts_milli = int(ts_float * 1000)
print("毫秒级时间戳(13位):", ts_milli)
# 示例输出: 毫秒级时间戳(13位): 1792135800000

2. 时间戳转 datetime(fromtimestamp)

使用 datetime.fromtimestamp(timestamp, tz=None) 可以将数字还原为时间对象。若不传入 tz 参数,默认返回宿主系统的本地时间。

from datetime import datetime, timezone

ts = 1792135800

# 1. 默认转为本地时间(若在东八区即 UTC+8)
local_dt = datetime.fromtimestamp(ts)
print("本地时间:", local_dt)
# 示例输出: 本地时间: 2026-10-16 15:30:00

# 2. 明确指定转为 UTC 标准时间
utc_dt = datetime.fromtimestamp(ts, tz=timezone.utc)
print("UTC 时间:", utc_dt)
# 示例输出: UTC 时间: 2026-10-16 07:30:00+00:00
注意: Python 3.12 起已正式弃用 datetime.utcnow() 与 datetime.utcfromtimestamp(),因为它们生成的是没有时区信息的朴素对象(Naive),容易引发静默计算错误。推荐统一使用 datetime.now(timezone.utc) 与 datetime.fromtimestamp(ts, tz=timezone.utc)。
Python时间日期处理代码片段:datetime格式化与时间戳转换
图 3:本地时间与 UTC 时间戳转换机制对比

三、高频场景与避坑指南

1. 毫秒级时间戳导致溢出错误

很多前端接口或 Java 后端传递的时间戳是 13 位毫秒数值(例如 1792135800000)。如果直接传入 fromtimestamp(),Python 会将其当作秒数解析,导致年份膨胀至数万年后并抛出 OverflowError 或 ValueError。

from datetime import datetime

raw_milli_ts = 1792135800000

# 必须先除以 1000 转换为秒
sec_ts = raw_milli_ts / 1000.0
dt = datetime.fromtimestamp(sec_ts)

print("正确转换结果:", dt.strftime("%Y-%m-%d %H:%M:%S"))
# 示例输出: 正确转换结果: 2026-10-16 15:30:00

2. 占位符大小写混淆

最容易笔误的占位符有两组:

  • 月份 vs 分钟:%m 代表月份(Month, 01-12),而 %M 代表分钟(Minute, 00-59)。
  • 24小时制 vs 12小时制:%H 代表 24 小时制(00-23),而 %I 代表 12 小时制(01-12,通常配合 %p 使用)。

3. 中文日期格式化技巧

在 Windows 环境下,直接在 strftime 中包含中文字符(如 "%Y年%m月%d日")可能会因为底层 C 运行时区域设置(locale)报错。最安全通用的做法是使用标准占位符格式化后替换,或者使用 Python 原生的字符串 format 方法:

from datetime import datetime

dt = datetime(2026, 10, 16, 15, 30, 0)

# 方案 1:format 字符串填充(全平台安全)
str_cn = "{dt.year}年{dt.month:02d}月{dt.day:02d}日 {dt.hour:02d}时{dt.minute:02d}分{dt.second:02d}秒".format(dt=dt)
print("安全中文格式:", str_cn)
# 示例输出: 安全中文格式: 2026年10月16日 15时30分00秒
Python时间日期处理代码片段:datetime格式化与时间戳转换
图 4:Python datetime 处理避坑指南与速查手册

四、总结

处理 Python 时间日期转换的关键在于确立单一事实标准:以 datetime 对象为核心中枢,对外部字符串展示使用 strftime / strptime,对底层时间戳存取使用 timestamp() / fromtimestamp()。在涉及跨服务或分布式应用时,始终显式注明时区信息(优先采用 UTC),能从根本上避免绝大多数时间偏差和解析异常。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表