Python datetime模块核心类包括date、time、datetime、timedelta和tzinfo,分别处理纯日期、纯时间、完整时间点、时间差及时区;需区分naive与aware时间,熟练使用strptime/strftime进行解析与格式化,并通过zoneinfo处理时区。

Python 的 datetime 模块是处理日期和时间最常用、最核心的内置工具,掌握它能高效应对绝大多数时间相关需求——从解析字符串、计算时间差,到生成时间序列、处理时区,都离不开它。
datetime 模块的核心类及其分工
模块中几个关键类各司其职,避免混淆是正确使用的前提:
- date:只处理年-月-日,不带时分秒,适合记录生日、节假日等纯日期场景
- time:只处理时:分:秒.微秒,不带日期,适用于定时任务触发点、营业时段等
- datetime:date + time 的组合,最常用,表示具体到秒(甚至微秒)的完整时间点
- timedelta:表示两个时间点之间的差值(如“3天2小时”),用于加减运算,不可单独存在
- tzinfo:抽象基类,实际使用中多通过 zoneinfo(Python 3.9+)或 pytz 提供具体时区实现
创建和格式化 datetime 对象
创建方式灵活,格式化则靠 strftime 和 strptime 两个方法配合:
- 用
datetime.now()获取本地当前时间;datetime.utcnow()获取 UTC 时间(注意:不带时区信息) - 指定构造:如
datetime(2025, 4, 1, 14, 30)表示 2025 年 4 月 1 日 14:30:00 - 字符串转 datetime:用
strptime("2025-04-01 14:30", "%Y-%m-%d %H:%M"),格式码必须严格匹配 - datetime 转字符串:用
dt.strftime("%Y年%m月%d日 %H:%M"),可自由定制输出样式
时间计算与比较操作
datetime 对象支持直接比较和算术运算,但要注意规则:
立即学习“Python免费学习笔记(深入)”;
- 相同类型(如 datetime 与 datetime)可直接用
>、==等比较,结果直观可靠 - 两个 datetime 相减得到 timedelta 对象,例如
dt2 - dt1返回间隔多少天、秒、微秒 - datetime 可与 timedelta 相加/相减,实现“3天后”“2小时前”等逻辑:
dt + timedelta(days=3, hours=2) - 注意:date 和 datetime 不能直接相减,需统一类型;无时区的 datetime 之间运算不考虑时区偏移
时区处理:从 naive 到 aware
没有时区信息的时间对象叫 naive,带时区的是 aware。混用会导致 TypeError:
- Python 3.9+ 推荐用 zoneinfo:先
from zoneinfo import ZoneInfo,再dt.replace(tzinfo=ZoneInfo("Asia/Shanghai"))或datetime.now(ZoneInfo("UTC")) - 转换时区:先确保原时间是 aware,再用
astimezone(ZoneInfo("US/Eastern")) - 避免用
datetime.now().replace(tzinfo=...)直接添加时区——这不会转换时间,只是硬打标签;应优先用带 tzinfo 参数的 now() 或 astimezone()
掌握 datetime 模块的关键在于理解类型边界、区分 naive/aware、熟练使用 strptime/strftime,并在涉及跨时区或长期存储时主动补全时区信息。不复杂但容易忽略。










