Python时间日期处理代码片段:datetime格式化与时间戳转换
详细讲解Python中datetime对象的字符串格式化与解析、Unix时间戳双向转换代码片段,包含时区陷阱排查与高频避坑指南。
在日常 Python 开发中,时间日期处理主要依赖内置的 datetime 模块。高频场景集中在两大环节:一是将时间对象与可读字符串相互转换(格式化与解析),二是将时间对象与 Unix 时间戳相互转换。本文给出即开即用的标准代码片段,剖析关键参数、时区差异与核心避坑点。
一、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 |
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
datetime.utcnow() 与 datetime.utcfromtimestamp(),因为它们生成的是没有时区信息的朴素对象(Naive),容易引发静默计算错误。推荐统一使用 datetime.now(timezone.utc) 与 datetime.fromtimestamp(ts, tz=timezone.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 对象为核心中枢,对外部字符串展示使用 strftime / strptime,对底层时间戳存取使用 timestamp() / fromtimestamp()。在涉及跨服务或分布式应用时,始终显式注明时区信息(优先采用 UTC),能从根本上避免绝大多数时间偏差和解析异常。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













