1. Python 日期与时间处理基础Python 中的日期和时间处理是每个开发者都必须掌握的核心技能。datetime 模块是处理日期和时间的主力军它提供了 date、time、datetime、timedelta 和 tzinfo 这几个关键类覆盖了日常开发中的绝大多数需求。datetime 模块的设计哲学是将日期和时间解耦为独立但可组合的对象。date 类只处理年月日time 类专注时分秒和时区而 datetime 则是两者的结合体。这种设计让代码更加清晰也避免了不必要的资源浪费。from datetime import date, time, datetime # 创建日期对象 today date.today() # 获取当前日期 print(f今天是 {today}) # 输出格式YYYY-MM-DD # 创建时间对象 current_time time(14, 30, 15) # 14:30:15 print(f当前时间是 {current_time}) # 完整的日期时间对象 now datetime.now() print(f现在是 {now})注意datetime.now() 返回的是本地时间如果需要UTC时间应该使用 datetime.utcnow()timedelta 是处理时间间隔的利器。它可以表示两个日期或时间之间的差值也支持日期时间的加减运算from datetime import timedelta one_day timedelta(days1) tomorrow today one_day print(f明天是 {tomorrow}) # 更复杂的计算 two_weeks_later now timedelta(weeks2, days3, hours5) print(f两周零三天五小时后是 {two_weeks_later})2. 日期时间格式化与解析实际项目中我们经常需要在日期时间对象和字符串之间相互转换。strftime() 方法用于将日期时间对象格式化为字符串而 strptime() 则用于将字符串解析为日期时间对象。Python 的格式化指令非常丰富以下是一些最常用的格式代码指令含义示例%Y四位年份2023%m两位月份01-12%d两位日期01-31%H24小时制小时00-23%M分钟00-59%S秒00-59%A完整星期名称Monday%a简写星期名称Mon%B完整月份名称January%b简写月份名称Jan# 格式化示例 formatted_date now.strftime(%Y-%m-%d %H:%M:%S) print(f格式化后的日期时间: {formatted_date}) # 解析字符串为datetime对象 date_str 2023-08-15 14:30:00 parsed_date datetime.strptime(date_str, %Y-%m-%d %H:%M:%S) print(f解析后的日期时间对象: {parsed_date})提示strptime 对格式要求非常严格输入字符串必须完全匹配格式字符串否则会抛出 ValueError在实际项目中我经常遇到各种非标准格式的日期字符串。这时可以先用正则表达式预处理字符串或者使用第三方库如 dateutil 的 parser 模块from dateutil import parser date_str August 15, 2023 2:30 PM parsed_date parser.parse(date_str) print(f智能解析结果: {parsed_date})3. 时区处理与国际化时区处理是日期时间编程中最容易出错的部分之一。Python 的 datetime 模块提供了 tzinfo 抽象基类来处理时区信息但实际使用时我们通常使用第三方库 pytz 或 Python 3.9 引入的 zoneinfo。from datetime import datetime import pytz # 创建带时区的datetime对象 utc_now datetime.now(pytz.utc) print(fUTC时间: {utc_now}) # 转换为上海时区 shanghai_tz pytz.timezone(Asia/Shanghai) shanghai_time utc_now.astimezone(shanghai_tz) print(f上海时间: {shanghai_time}) # 处理夏令时 paris_tz pytz.timezone(Europe/Paris) paris_time shanghai_time.astimezone(paris_tz) print(f巴黎时间: {paris_time})重要经验永远在内部使用UTC时间存储和计算只在显示给用户时转换为本地时间Python 3.9 引入了 zoneinfo 作为标准库的一部分它比 pytz 更现代API也更简洁from zoneinfo import ZoneInfo from datetime import datetime # 使用zoneinfo tokyo_tz ZoneInfo(Asia/Tokyo) tokyo_time datetime.now(tokyo_tz) print(f东京时间: {tokyo_time})4. 高级日期时间操作4.1 日期范围生成处理时间序列数据时经常需要生成日期范围。Python 标准库没有直接提供这个功能但我们可以用简单的循环实现from datetime import date, timedelta def date_range(start_date, end_date): current_date start_date while current_date end_date: yield current_date current_date timedelta(days1) # 使用示例 start date(2023, 8, 1) end date(2023, 8, 10) for day in date_range(start, end): print(day)对于更复杂的需求pandas 的 date_range 函数是更好的选择import pandas as pd # 生成工作日日期范围 weekdays pd.date_range(start2023-08-01, end2023-08-31, freqB) print(八月的工作日:) print(weekdays)4.2 工作日计算计算工作日排除周末和节假日是业务系统中的常见需求。我们可以使用 python 的 workalendar 库from workalendar.asia import China from datetime import date cal China() start_date date(2023, 8, 1) end_date date(2023, 8, 31) # 计算两个日期之间的工作日天数 workdays cal.get_working_days_delta(start_date, end_date) print(f2023年8月有 {workdays} 个工作日) # 添加工作日 target_date cal.add_working_days(start_date, 10) print(f从8月1日开始10个工作日后是 {target_date})4.3 性能优化技巧处理大量日期时间数据时性能可能成为瓶颈。以下是一些优化建议避免频繁的字符串解析和格式化尽量保持datetime对象形式使用time.monotonic()而不是time.time()进行性能测量对于固定格式的日期字符串考虑使用strptime的快速替代方案from datetime import datetime def fast_parse(date_str): return datetime( int(date_str[0:4]), # year int(date_str[5:7]), # month int(date_str[8:10]), # day int(date_str[11:13]), # hour int(date_str[14:16]), # minute int(date_str[17:19]) # second ) # 比strptime快2-3倍 date_str 2023-08-15 14:30:00 parsed_date fast_parse(date_str)5. 常见问题与解决方案5.1 日期比较与排序datetime对象原生支持比较操作可以轻松进行排序from datetime import datetime dates [ datetime(2023, 8, 15), datetime(2023, 7, 1), datetime(2023, 9, 1) ] # 排序 sorted_dates sorted(dates) print(按时间排序:) for d in sorted_dates: print(d)注意比较带时区和不带时区的datetime对象会引发TypeError5.2 处理闰年和闰秒Python的datetime模块自动处理闰年from datetime import date # 检查闰年 def is_leap_year(year): return date(year, 1, 1).strftime(%j) 366 print(f2020年是闰年吗? {is_leap_year(2020)}) print(f2023年是闰年吗? {is_leap_year(2023)})对于需要处理闰秒的特殊场景可以考虑使用专门的库如 leapseconds。5.3 跨平台兼容性问题不同平台对日期时间的处理可能有细微差异。特别是在Windows和Linux之间迁移代码时要注意strftime的某些格式指令在不同平台表现不同如%z时区偏移量时区数据库可能不同解析宽松程度可能有差异建议在跨平台项目中明确指定时区使用标准格式ISO 8601编写平台兼容性测试6. 第三方库推荐虽然Python标准库已经提供了强大的日期时间处理能力但在特定场景下这些第三方库可能更有优势arrow更人性化的API设计import arrow utc arrow.utcnow() local utc.to(Asia/Shanghai) print(local.format(YYYY-MM-DD HH:mm:ss))pendulum替代datetime的解决方案解决了许多痛点import pendulum dt pendulum.now(Asia/Tokyo) print(dt.diff_for_humans()) # 2 hours agomaya非常简单的API适合快速开发import maya dt maya.parse(2023-08-15T14:30:00Z).datetime() print(dt)dateutil标准库的有力补充from dateutil.relativedelta import relativedelta next_month datetime.now() relativedelta(months1) print(f下个月今天是 {next_month})pandas处理时间序列数据的首选import pandas as pd ts pd.Timestamp.now() print(ts.floor(D)) # 当天零点7. 实际项目经验分享在多年的Python开发中我总结了以下日期时间处理的最佳实践数据库存储始终以UTC时间存储并在字段名中明确标示如created_at_utcAPI设计接收和返回ISO 8601格式字符串在文档中明确时区要求为日期范围查询提供合理的默认值日志记录使用UTC时间并包含时区信息格式如2023-08-15T14:30:00Z测试技巧from unittest.mock import patch from datetime import datetime def test_time_sensitive_code(): with patch(datetime.datetime) as mock_datetime: mock_datetime.now.return_value datetime(2023, 8, 15) # 测试代码将认为当前时间是2023-08-15性能关键代码考虑使用整数时间戳代替datetime对象Django项目注意USE_TZ设置建议设置为True时区转换陷阱避免直接修改datetime对象的tzinfo属性应该使用astimezone方法一个常见的坑是混淆naive和aware的datetime对象。我建议在项目早期建立明确的规范from datetime import datetime from zoneinfo import ZoneInfo def ensure_utc(dt): 确保datetime对象是UTC时区的aware对象 if dt.tzinfo is None: return dt.replace(tzinfoZoneInfo(UTC)) return dt.astimezone(ZoneInfo(UTC)) def ensure_naive(dt): 转换为naive的本地时间 if dt.tzinfo is not None: return dt.astimezone(ZoneInfo(Asia/Shanghai)).replace(tzinfoNone) return dt