python必背源代码日期时间datetime代码
系统梳理 Python datetime 模块必背核心源代码与操作范式,涵盖对象模型构造、字符串互转解析、时间偏移计算、时间戳与时区工程实践及避坑指南。
处理日期与时间是 Python 后端开发、数据清洗、日志记录和自动化任务中最基础的操作。Python 标准库自带的 datetime 模块无需第三方依赖,提供了完整的时间对象模型、字符串格式化与解析通道、时间跨度计算及时间戳转换功能。掌握该模块的最高效方式不是记忆几十个衍生函数,而是牢记基础对象构造、字符串互转、timedelta 时间推算以及时间戳处理这四组核心代码片段,并规避时区和大小写格式化中的典型隐患。
一、datetime 核心对象模型与基础构造代码
datetime 模块内部将时间维度拆分为几个具有明确职责的基础类,最核心的是以下四个:
date:处理纯年月日(无时分秒概念),适用于生日、节假日、统计日期。time:处理纯时分秒及微秒(无年月日概念),适用于打卡时间段、营业营业时间判定。datetime:聚合了date与time,表示具体的时刻点,是开发中使用频率最高的主类。timedelta:表示时间间隔或偏移量,用于日期的加减运算与跨度测量。
获取当前时间以及手动构造指定时刻,是每个 Python 脚本不可或缺的起点代码:
from datetime import datetime, date, time
# 1. 获取当前系统时间对象(精确到微秒)
now = datetime.now()
print("当前本地完整时间:", now)
# 2. 仅获取当前日期
today = date.today()
print("今日日期:", today)
# 3. 手工构造特定的日期时间对象 (年, 月, 日, 时, 分, 秒)
target_dt = datetime(2026, 11, 17, 8, 30, 0)
print("指定时间点:", target_dt)
# 4. 快速提取各个时间维度属性
print(f"年份: {now.year}, 月份: {now.month}, 日期: {now.day}")
print(f"小时: {now.hour}, 分钟: {now.minute}, 秒: {now.second}")
print(f"星期几(0表示周一, 6表示周日): {now.weekday()}")
二、字符串与 datetime 互相转换:strftime 与 strptime
外部接口、数据库字段以及前端传参通常采用字符串表示时间,而在 Python 代码内部必须转为 datetime 对象才能进行计算与比较。两者的双向转换遵循标准格式化代码:
strftime(String Format Time):将datetime对象按指定模板格式化为人类可读的字符串。strptime(String Parse Time):将格式化时间字符串解析为内存中的datetime对象。
from datetime import datetime
now = datetime.now()
# 1. 对象转字符串 (strftime):输出形如 2026-11-17 08:30:00
str_format = now.strftime("%Y-%m-%d %H:%M:%S")
print("格式化字符串:", str_format)
# 自定义带中文的展示格式
chinese_format = now.strftime("%Y年%m月%d日 %H时%M分")
print("中文字符串:", chinese_format)
# 2. 字符串转对象 (strptime):严格按照模板解析
source_text = "2026-11-17 08:30:00"
parsed_dt = datetime.strptime(source_text, "%Y-%m-%d %H:%M:%S")
print("解析得到的对象:", parsed_dt, "类型:", type(parsed_dt))
# 3. 现代 Python 推荐的 ISO 8601 标准互转通道(无需记忆格式符)
iso_str = now.isoformat()
print("ISO 8601 字符串:", iso_str)
dt_from_iso = datetime.fromisoformat(iso_str)
print("从 ISO 解析恢复:", dt_from_iso)
进行格式化操作时,最常用的占位符如下表所示,务必注意大小写:
| 占位符 | 含义 | 取值范围 / 示例 |
|---|---|---|
%Y |
四位完整年份(注意大写) | 2026, 2027 |
%m |
两位月份(数字表示,补零) | 01 至 12 |
%d |
两位日(数字表示,补零) | 01 至 31 |
%H |
24小时制小时数(00-23) | 08, 14, 23 |
%M |
两位分钟数(注意大写,区别于月份) | 00 至 59 |
%S |
两位秒数 | 00 至 59 |
%f |
微秒数(6位数字) | 000000 至 999999 |
三、时间加减计算与跨度推导:timedelta 实战
日期时间的加减不能直接使用普通整数相加,而必须借助 timedelta 类。timedelta 支持指定 days、seconds、microseconds、milliseconds、minutes、hours 与 weeks。
from datetime import datetime, timedelta
now = datetime.now()
# 1. 计算未来与过去时刻
tomorrow = now + timedelta(days=1)
yesterday = now - timedelta(days=1)
future_3_weeks = now + timedelta(weeks=3)
earlier_2_hours = now - timedelta(hours=2, minutes=30)
print("明天此时:", tomorrow.strftime("%Y-%m-%d %H:%M:%S"))
print("昨天此时:", yesterday.strftime("%Y-%m-%d %H:%M:%S"))
print("2.5小时前:", earlier_2_hours.strftime("%Y-%m-%d %H:%M:%S"))
# 2. 计算两个时刻之间的实际跨度
t1 = datetime(2026, 11, 10, 10, 0, 0)
t2 = datetime(2026, 11, 17, 16, 30, 0)
duration = t2 - t1
print("时间跨度对象:", duration)
print("相差整天数 (duration.days):", duration.days)
print("剩余秒数 (duration.seconds):", duration.seconds)
print("总换算秒数 (duration.total_seconds()):", duration.total_seconds())
duration.seconds 当作全部差值。duration.seconds 仅仅代表除去整天之后的日内剩余秒数(范围在 0 至 86399 之间);如果需要获取两个时刻之间绝对的秒差值,必须调用 duration.total_seconds()。
四、时间戳与时区:Naive 与 Aware 的工程实践
底层数据存储、缓存队列(如 Redis)或消息传递通常采用 Unix 时间戳(即从 1970 年 1 月 1 日 00:00:00 UTC 开始计算的总秒数浮点值)。在 Python 中,可以通过以下代码快速在时间戳与 datetime 之间互转:
from datetime import datetime, timezone, timedelta
now = datetime.now()
# 1. datetime 转换为 Unix 时间戳 (float)
ts = now.timestamp()
print("Unix 时间戳:", ts)
# 2. 时间戳恢复为本地 datetime 对象
restored_dt = datetime.fromtimestamp(ts)
print("从时间戳恢复:", restored_dt)
# 3. 处理带有时区 (Aware) 的标准时间
# 获取标准 UTC 时间
utc_now = datetime.now(timezone.utc)
print("UTC 时间:", utc_now)
# 构造东八区 (北京时间 UTC+8)
beijing_tz = timezone(timedelta(hours=8))
beijing_now = utc_now.astimezone(beijing_tz)
print("北京时间:", beijing_now)
在 Python 的 datetime 规范中,对象分为两类:
- Naive(无时区信息):
dt.tzinfo为None,默认仅代表本地时间概念。 - Aware(有时区信息):
dt.tzinfo被赋予具体时区对象,能够明确标识全球唯一的物理时刻。
如果在代码中试图拿一个 Naive 对象和一个 Aware 对象直接做减法或比较,Python 将抛出 TypeError: can't subtract offset-naive and offset-aware datetimes。工程最佳实践是:在系统入口处统一将输入转化为 UTC 时间或统一附带时区后再进行业务逻辑处理。
五、必背速查卡片与常见错误防范清单
综合以上核心模块,在实际编写与审查代码时,需要防范以下三大常见隐蔽错误:
- 混淆格式化字符的大小写:
%m表示月份(01-12),而%M表示分钟(00-59);%Y表示四位完整年份(2026),而%y表示两位缩写年份(26)。 - 试图在 timedelta 中传月份或年份:
timedelta(months=1)或timedelta(years=1)会直接抛出参数错误,因为不同月份天数不均,标准库出于精度严谨性禁止此类模糊入参。若需计算自然月增减,应使用calendar模块或第三方库python-dateutil的relativedelta。 - 忽略夏令时与时区差异:在跨国业务和服务器集群交互中,避免使用不带时区信息的
datetime.now()拼接字符串,优先采用datetime.now(timezone.utc)或时间戳交互。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













