首页/新闻资讯/正文详情

Python日期和时间完全指南与实战

发布时间:2026/11/20 8:04:28 来源:云帆数科 栏目:资讯中心
Python日期和时间完全指南与实战
前言日期时间看起来是最没技术含量的主题拿当前时间、格式化、算差值三行代码的事。但真实项目里它是 bug 的高产区。原因在于这个领域有三个独立坐标轴——时刻、时区、日历规则——而datetime模块把这些轴拆成了不同对象混用就会出错。常见的误解有这些以为datetime.now()拿到的就是「现在的时间」它其实是你机器本地时区下的墙上时间换台机器结果就不同以为有时区信息的时间可以和无时区的时间直接相减不能会抛TypeError以为strftime的格式符哪个都能随便用%Y和%y、%U和%W差别很大以为夏令时只是「快一小时」它会让某些本地时刻出现两次或干脆不存在。本文按「对象类型 → 时区 → 格式化与解析 → 实战」的顺序讲一遍。示例在 Python 3.8 及以上可运行涉及更新版本的地方会单独标注。一、五个核心类型datetime模块里真正需要记住的类只有五个类型表示什么典型构造date日期年、月、日date(2026, 10, 7)time时刻时、分、秒、微秒time(13, 30, 0)datetime日期 时刻datetime(2026, 10, 7, 13, 30)timedelta时间跨度差值timedelta(days7)tzinfo时区信息基类一般不直接实例化datetime是date的子类所以它同时拥有日期和时刻的方法。三个类型都是不可变immutable的任何「修改」都返回新对象。# 适用于 Python 3.8from datetime import date, datetime, time, timedeltad date(2026, 10, 7)print(d.year, d.month, d.day, d.weekday()) # 2026 10 7 2print(d.isoformat()) # 2026-10-07dt datetime(2026, 10, 7, 13, 30, 15, 500000)print(dt.hour, dt.minute, dt.second, dt.microsecond) # 13 30 15 500000weekday()返回0 到 60 是周一isoweekday()返回1 到 71 是周一。这两个方法差一用错不会报错只会得到偏移一天的结论是典型的静默错误。date上还有isocalendar()返回 ISO 年、ISO 周数和 ISO 星期几。timedelta的构造参数是days、seconds、microseconds、milliseconds、minutes、hours、weeks全部是关键字参数且内部会归一化。写timedelta(7, 3)得到的是 7 天 3 秒按位置填days, seconds不是 7 天 3 小时——务必全用关键字。# 适用于 Python 3.8from datetime import datetime, timedeltastart datetime(2026, 10, 7, 9, 0, 0)end start timedelta(hours2, minutes30)gap end - startprint(gap) # 2:30:00print(gap.total_seconds()) # 9000.0print(gap.days, gap.seconds) # 0 9000注意gap.days和gap.seconds的组合方式timedelta内部只用days、seconds、microseconds三个字段存值且seconds恒在0到86399之间。所以负的差值会表现为「天数为负、秒数为正」。想要总秒数一律用total_seconds()。二、naive 与 aware所有时区问题的起点这是整个模块最重要的概念区分。naive朴素tzinfo为None意思是「某个地方墙上的时间」但没说哪个地方。aware有知带tzinfo能唯一确定一个绝对时刻。两者不能相减# 适用于 Python 3.8from datetime import datetime, timezonenaive datetime(2026, 10, 7, 12, 0)aware datetime(2026, 10, 7, 12, 0, tzinfotimezone.utc)print(aware - aware) # 0:00:00同类型可以运算# naive - aware # TypeError: cant subtract offset-naive and offset-aware datetimes比较、同样会抛TypeError。这个设计是刻意的Python 不替你猜 naive 时间代表哪个时区因为猜错比报错更危险。修timezone.utc有个更短的别名datetime.UTC它是 Python 3.11 新增的等价于timezone.utc这个单例。3.10 及更早只能写timezone.utc。反过来datetime.now()和datetime.today()返回的都是naive 的本地时间。要拿「带 UTC 的当前时刻」正确写法是# 适用于 Python 3.8from datetime import datetime, timezoneprint(datetime.now(timezone.utc)) # 带 UTC 时区从 3.12 起datetime.utcnow()与datetime.utcfromtimestamp()已被弃用官方建议改用datetime.now(UTC)和datetime.fromtimestamp(t, UTC)。旧代码里这两个名字很常见看到要知道它已经被标记过时。三、时区、格式化与解析时区zoneinfo 与时间戳处理具体时区用zoneinfo.ZoneInfo它是Python 3.9 新增的模块用 IANA 时区数据库的键名# 适用于 Python 3.9from datetime import datetimefrom zoneinfo import ZoneInfobeijing ZoneInfo(Asia/Shanghai)new_york ZoneInfo(America/New_York)meeting datetime(2026, 10, 7, 9, 0, tzinfobeijing)print(meeting.isoformat()) # 2026-10-07T09:00:0008:00print(meeting.astimezone(new_york).isoformat()) # 同一时刻换成纽约时间astimezone(tz)转换的是表示方式不是时刻本身转换前后代表的是同一个绝对时间点只是显示的时区和墙上时间变了。这一点初学时最容易搞反。3.8 及更早没有zoneinfo要么用第三方库要么手写tzinfo子类要么退回time模块的本地时区处理——后者会受机器设置影响不可靠。另一条路是时间戳timestamp从 epoch1970-01-01 UTC起的秒数带小数部分表示微秒。时间戳是绝对的、与时区无关的适合做存储与传输。# 适用于 Python 3.8from datetime import datetime, timezonets 1790000000dt datetime.fromtimestamp(ts, tztimezone.utc)print(dt.isoformat())print(dt.timestamp()) # 1759... 回到时间戳要小心dt.timestamp()的行为对 aware 的datetime它返回真实的绝对时间戳对naive 的datetime它按系统本地时区解释所以换台机器结果就变了。存库和传参一律用 aware 时间或时间戳不要存 naive 的本地时间。还有一个易错点时间戳的范围。在常见平台上fromtimestamp能处理的时间戳有上下界超出范围会抛OverflowError/OSError具体边界与平台有关不要假定它能表示任意年份。格式化与解析strftime(format)把时间对象转成字符串strptime(date_string, format)反过来解析。一个容易被忽视的细节strftime是实例方法strptime是类方法date和datetime上都有。常用格式符格式符含义输出示例%Y四位年2026%y两位年26%m两位月10%d两位日07%H/%I24 小时制 / 12 小时制的小时13 / 01%M/%S分 / 秒30 / 15%f微秒补零到 6 位500000%p上午/下午依赖区域设置PM%zUTC 偏移0800%Z时区名naive 时为空串UTC%j一年中的第几天280%U/%W周数以周日 / 周一为一周开始40 / 40%A/%a星期全名 / 缩写依赖区域设置Wednesday / Wed%B/%b月份全名 / 缩写依赖区域设置October / Oct三点提醒。第一%Y和%y不通用。解析两位年份时世纪靠推断规则决定容易和预期不一致存储和交换一律用%Y四位。第二%A、%B、%p这些依赖区域设置locale而 Python 进程启动后改 locale 会影响整个进程多线程下更麻烦。不要在机器可读的格式里用它们它们只适合给人看的输出。第三从 3.13 起解析时格式串里含「日」但不含「年」会发出DeprecationWarning官方计划在后续版本把它改成错误或改成默认闰年。所以像datetime.strptime(10-07, %m-%d)这种写法要避免解析时必须把年给全。# 适用于 Python 3.8from datetime import datetimedt datetime.strptime(2026-10-07 13:30:15, %Y-%m-%d %H:%M:%S)print(dt.year, dt.hour) # 2026 13print(dt.strftime(%Y/%m/%d %H:%M)) # 2026/10/07 13:30另外还有isoformat()和fromisoformat()这一对isoformat()输出 ISO 8601 风格的字符串从 Python 3.11 起fromisoformat支持的格式范围大幅扩展此前只能解析isoformat()自己能产出的那几种。如果你的目标版本是 3.11优先用 ISO 格式在机器间传递时间比自定义strftime格式更稳。四、夏令时与综合示例夏令时真实存在却最容易被忽略的坑zoneinfo会正确处理夏令时DST。这带来两个反直觉的现象现象一某些本地时刻出现两次。夏令时结束那天本地时钟会往回拨一小时于是同一个本地墙上时间在一小时内出现两次但对应两个不同的绝对时刻。datetime用fold属性来区分fold0表示第一次出现fold1表示第二次。现象二某些本地时刻根本不存在。夏令时开始那天本地时钟向前跳一小时被跳过的那段墙上时间在现实中不存在。构造这样的datetime不会报错但utcoffset()会给出一个补偿后的结果。# 适用于 Python 3.9from datetime import datetimefrom zoneinfo import ZoneInfotz ZoneInfo(America/New_York)ambiguous datetime(2026, 11, 1, 1, 30, tzinfotz)print(ambiguous.fold) # 0print(ambiguous.utcoffset())print(ambiguous.replace(fold1).utcoffset()) # 另一个偏移实践上的结论很简单做时间运算和存储时用 UTC只在最后展示给用户时才转成本地时区。这样夏令时的歧义只在展示层出现不会污染计算。一个综合示例把上面几块拼起来给定一批带时区的事件字符串统一换算到 UTC 并统计时间跨度。# 适用于 Python 3.9from datetime import datetime, timezonefrom zoneinfo import ZoneInfoRECORDS [2026-10-07 09:00:00|Asia/Shanghai,2026-10-07 03:00:00|Europe/London,2026-10-07 00:00:00|America/New_York,]def parse(record):把 时间|时区名 解析成 aware 的 datetime。stamp, zone_name record.split(|)naive datetime.strptime(stamp, %Y-%m-%d %H:%M:%S)return naive.replace(tzinfoZoneInfo(zone_name))moments [parse(r) for r in RECORDS]utc_moments [m.astimezone(timezone.utc) for m in moments]for original, utc in zip(moments, utc_moments):print(original.isoformat(), -, utc.isoformat())span max(utc_moments) - min(utc_moments)print(最大跨度, span)逐行推演一下parse先按无时区格式解析出 naive 时间再用replace(tzinfo...)挂上时区。这里用replace是可行的因为这批时间点都是「当地墙上时间」语义就是「在该时区的这个时刻」。但要注意replace不是换算它只是换个标签如果原对象已经带时区replace会连同偏移一起改掉语义就变了。要把一个 aware 时间转到另一个时区必须用astimezone。三个输入按各自时区换算到 UTC 后都对应世界时同一天的不同钟点max - min就是它们之间的真实时间跨度。因为结果全部是 aware 的减法才成立——这正是前面反复强调的那条规则的应用。常见坑点1. naive 与 aware 相减❌datetime.now() - datetime.now(timezone.utc)抛TypeError: cant subtract offset-naive and offset-aware datetimes。 ✅ 两边都统一成 aware推荐 UTC或者都转成时间戳后相减。2.timedelta位置参数❌timedelta(7, 3)当作 7 天 3 小时实际是 7 天 3 秒。 ✅ 全部用关键字timedelta(days7, hours3)。3.weekday()与isoweekday()混用❌ 以为weekday()返回 1 到 7周一为 1实际是 0 到 6周一为 0。 ✅weekday()用 0 基数isoweekday()用 1 基数需要 ISO 值时用isocalendar()。4. 用utcnow()/utcfromtimestamp()❌ 沿用老代码里的datetime.utcnow()得到的其实是 naive 时间很多时区库不认。 ✅ 从 3.12 起这两个已被弃用改用datetime.now(timezone.utc)和datetime.fromtimestamp(t, timezone.utc)。5.replace(tzinfo...)当成时区换算❌ 想把「北京时间 9 点」变成「纽约时间」写dt.replace(tzinfoZoneInfo(America/New_York))——墙上时间没变时刻却变了。 ✅ 换算用dt.astimezone(ZoneInfo(America/New_York))。6. 解析格式串里缺年❌datetime.strptime(10-07, %m-%d)从 3.13 起发DeprecationWarning未来可能直接报错。 ✅ 格式串里带上%Y把年份写全。7. 用%A/%B做机器可读格式❌ 把星期、月份的英文名写进文件名或数据库字段结果一旦换 locale 就解析不了。 ✅ 机器可读一律用数字格式符%Y%m%d或 ISO 8601。8. 存 naive 的本地时间❌ 数据库里存datetime.now()的结果换台服务器时区不同读出来的时刻就变了。 ✅ 存 UTC 的 aware 时间或时间戳只在展示层转本地时区。总结需求推荐做法关键提醒取「现在」datetime.now(timezone.utc)别用utcnow()3.12 起已弃用表示某个时区的时刻ZoneInfo(Asia/Shanghai)需 Python 3.93.11 可用datetime.UTC两个时间相减都转成 aware 或都用时间戳naive 与 aware 相减会TypeError换算时区astimezone(tz)不是replace格式化成字符串strftime实例方法机器可读别用依赖 locale 的格式符从字符串解析strptime类方法格式串必须含%Y存储与传输UTC 时间戳或 ISO 8601 字符串不要存 naive 本地时间日期时间的坑几乎都能归结到一句原则内部一律用 UTC展示时才转本地时刻用 aware 表示跨度用timedelta。记住这条无论换到哪个项目、哪个时区代码都不会因为「服务器在哪个机房」而出现难以复现的偏差。

相关推荐

FX系列PLC兼容源码拆解:扫描周期、通信与回环测试实战
FX系列PLC兼容源码拆解:扫描周期、通信与回环测试实战

简介:面向三菱FX3U源码学习、嵌入式工控开发与PLC底层逻辑研究的资料包,围绕基于STM32F407平台的FX3U V50.0版程序架构展开,适合需要理解指令实现、通信扩展与在线监视机制的开发者参考。包内共7个文件,以4个txt说明文档为主&… · 2026/11/20 7:59:28

Day.js:轻量级JavaScript日期处理库的核心优势与实践
Day.js:轻量级JavaScript日期处理库的核心优势与实践

1. 为什么选择Day.js处理日期时间在JavaScript生态中处理日期时间从来都不是件轻松的事。我至今还记得2018年那个加班的深夜,当时项目中使用Moment.js导致打包体积暴增,首屏加载时间超标被客户投诉的场景。正是那次经历让我开始寻找替代方案,… · 2026/11/20 8:02:22

昇腾AI自定义算子开发实战:从原理到性能优化
昇腾AI自定义算子开发实战:从原理到性能优化

1. CANN生态下的自定义算子开发全景在昇腾AI处理器生态中,自定义算子开发是突破框架原生能力限制的关键技术手段。最近在图像超分项目中,我遇到了框架原生算子无法满足特殊卷积计算需求的情况,通过custom-op机制成功实现了性能优化。本文将基… · 2026/11/20 10:45:41

高级电工证几级最高多少钱才能拿到证书上岗找工作
高级电工证几级最高多少钱才能拿到证书上岗找工作

高级电工证几级最高多少钱才能拿到证书上岗找工作 你是不是也在为找不到合适的工作发愁?特种作业证成了很多求职者的“敲门砖”,特别是高级电工证,成了电工行业的“通行证”。但很多人不知道高级电工证到底有几级,多少钱才能拿到,能不能顺利上岗?今天就… · 2026/11/20 19:24:58

国外电工证国内电工多久拿证全流程详解
国外电工证国内电工多久拿证全流程详解

国外电工证国内电工多久拿证全流程详解 之前考的证在外省能不能转过来?这几乎是所有准备把国外电工证转成国内电工证的朋友最关心的问题。尤其是在国内从事电力相关工作的外国电工,或者在国外学习电工技术后回国就业的人,往往面临证件转换的难题。本文从信… · 2026/11/20 19:24:58

没学历也能报淅川电工证?官方报名入口全攻略
没学历也能报淅川电工证?官方报名入口全攻略

没学历也能报淅川电工证?官方报名入口全攻略 学历不高怕报不上名?别慌, 淅川电工证 的报考门槛其实比你想的低很多, 官方报名入口… · 2026/11/20 19:24:58

许昌市低压电工证报名多少钱?怕考不过白交培训费的看过来
许昌市低压电工证报名多少钱?怕考不过白交培训费的看过来

许昌市低压电工证报名多少钱?怕考不过白交培训费的看过来 你是不是也担心自己报名了许昌市低压电工证,结果考试没过,钱白花了?别急,这篇文章就是为你准备的。今天咱们不扯虚的,讲干货,讲你最关心的: 许昌市低压电工证报名多少钱… · 2026/11/20 19:24:58

高压电工证可以出售吗怎么考最稳妥考前押题帮你上岸
高压电工证可以出售吗怎么考最稳妥考前押题帮你上岸

高压电工证可以出售吗怎么考最稳妥考前押题帮你上岸 你急需特种作业证才能上岗找工作,高压电工证可以出售吗这个问题,其实你根本不用担心,正规渠道是不能出售的,但你可以通过正规报考拿到证书。考前押题资料,现在网上很多,但得挑靠谱的。别再找什么“包… · 2026/11/20 19:24:58

江阴在哪办电工证官方回应怕考不过白交培训费?
江阴在哪办电工证官方回应怕考不过白交培训费?

江阴在哪办电工证官方回应怕考不过白交培训费? 怕考不过白交培训费?江阴在哪办电工证,官方回应来了,别再被坑!很多准备在江阴考电工证的朋友,最担心的就是培训费花了,考试却不过,钱打水漂。其实,只要选对机构,认真备考,通过率并不低,关键是要知道… · 2026/11/20 19:23:58

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

建设厅特种工周三报名怎么弄?上岗必备别被中介坑
建设厅特种工周三报名怎么弄?上岗必备别被中介坑

建设厅特种工周三报名怎么弄?上岗必备别被中介坑 不知道去哪报名怕被中介坑?作为商丘某高校工程类应届毕业生,小李最近就遇到了这样的困扰。他刚毕业,正在找实习岗位,发现很多工地都要求持有特种作业操作证,尤其是【建设厅特种工周三报名】这个时间点,… · 2026/11/20 0:00:54

中专考的中级电工证内部消息全攻略
中专考的中级电工证内部消息全攻略

中专考的中级电工证内部消息全攻略 你中专毕业,手头有中级电工证,但不知道从哪开始报名,怕被中介坑?别急,这篇文章就是为你量身定制的“内部消息”,帮你避开报名陷阱,稳稳拿到证书。… · 2026/11/20 0:00:54

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价
外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价

外省电工证能转过来吗?电子证书怎么查电工作业教学效果评价 之前考的证在外省能不能转过来?这几乎是所有在外地打拼的电工从业者最关心的问题。特别是像洛阳这样的工业城市,很多电工证是在外地考的,现在想在当地用,流程是不是很复杂?其实,只要搞清楚… · 2026/11/20 0:00:54

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码