09-扩展知识——08. timedelta 类

08. timedelta 类 - 时间差

概述

timedelta类表示两个日期或时间之间的差值（持续时间）。它支持天、秒、微秒级别的精度，是时间运算的核心工具。

1. timedelta 基础

1.1 参数详解

timedelta支持以下参数，所有参数都是可选的，默认值为 0：

fromdatetimeimporttimedelta# 各种创建方式td1=timedelta(days=5,hours=3,minutes=30)td2=timedelta(weeks=2,seconds=3600)td3=timedelta(milliseconds=1500)# 等同于 1.5 秒print(f"td1:{td1}")# 5 days, 3:30:00print(f"td2:{td2}")# 14 days, 1:00:00print(f"td3:{td3}")# 0:00:01.500000

1.2 最小和最大时间差

fromdatetimeimporttimedelta# 最小时间差（1微秒）min_td=timedelta.resolutionprint(f"最小时间差:{min_td}")# 0:00:00.000001# 最大时间差max_td=timedelta(days=999999999,seconds=86399,microseconds=999999)print(f"最大时间差:{max_td}")# 999999999 days, 23:59:59.999999

2. timedelta 属性

fromdatetimeimporttimedelta td=timedelta(days=5,hours=3,minutes=30,seconds=15,microseconds=500000)# 注意：这些属性是归一化后的值print(f"天数:{td.days}")# 5print(f"秒数部分:{td.seconds}")# 12615 (3*3600 + 30*60 + 15)print(f"微秒部分:{td.microseconds}")# 500000

2.1 归一化规则

fromdatetimeimporttimedelta# 秒数超过 86400 会自动进位到天td1=timedelta(seconds=90000)print(td1)# 1 day, 1:00:00# 微秒超过 1000000 会自动进位到秒td2=timedelta(microseconds=1500000)print(td2)# 0:00:01.500000# 负值归一化td3=timedelta(days=-1,seconds=3600)print(td3)# -1 day, 1:00:00 (实际是 -23:00:00)# 获取实际总秒数td4=timedelta(days=-1,seconds=3600)print(f"总秒数:{td4.total_seconds()}")# -82800.0

3. timedelta 方法

3.1 total_seconds() - 总秒数

fromdatetimeimporttimedelta td=timedelta(days=5,hours=3,minutes=30,seconds=15)# 总秒数total_sec=td.total_seconds()print(f"总秒数:{total_sec}")# 5*86400 + 3*3600 + 30*60 + 15 = 444615.0# 转换为其他单位print(f"总分钟:{total_sec/60:.2f}")# 7410.25print(f"总小时:{total_sec/3600:.2f}")# 123.50print(f"总天数:{total_sec/86400:.2f}")# 5.15

4. timedelta 运算

4.1 算术运算

fromdatetimeimporttimedelta td1=timedelta(days=5,hours=3)td2=timedelta(days=2,hours=5)# 加法print(f"加法:{td1+td2}")# 7 days, 8:00:00# 减法print(f"减法:{td1-td2}")# 2 days, 22:00:00# 乘法print(f"乘法:{td1*2}")# 10 days, 6:00:00# 除法print(f"除法:{td1/2}")# 2 days, 13:30:00print(f"整除:{td1//2}")# 2 days, 13:30:00# 取模td3=timedelta(hours=10)td4=timedelta(hours=3)print(f"取模:{td3%td4}")# 1:00:00# 取反print(f"取反:{-td1}")# -5 days, 21:00:00# 绝对值print(f"绝对值:{abs(-td1)}")# 5 days, 3:00:00

4.2 比较运算

fromdatetimeimporttimedelta td1=timedelta(days=5)td2=timedelta(days=10)td3=timedelta(days=5)print(f"td1 < td2:{td1<td2}")# Trueprint(f"td1 > td2:{td1>td2}")# Falseprint(f"td1 == td3:{td1==td3}")# Trueprint(f"td1 != td2:{td1!=td2}")# True

5. 与 datetime/date 的运算

5.1 datetime + timedelta

fromdatetimeimportdatetime,timedelta now=datetime(2026,4,19,9,30,0)# 未来时间future=now+timedelta(days=7,hours=3)past=now-timedelta(days=3,hours=2)print(f"现在:{now}")print(f"7天3小时后:{future}")print(f"3天2小时前:{past}")

5.2 date + timedelta

fromdatetimeimportdate,timedelta today=date(2026,4,19)# 未来日期tomorrow=today+timedelta(days=1)yesterday=today-timedelta(days=1)next_week=today+timedelta(weeks=1)print(f"今天:{today}")print(f"明天:{tomorrow}")print(f"昨天:{yesterday}")print(f"下周:{next_week}")

5.3 datetime 差值

fromdatetimeimportdatetime start=datetime(2026,4,19,9,0,0)end=datetime(2026,4,19,17,30,0)diff=end-startprint(f"时间差:{diff}")# 8:30:00print(f"天数:{diff.days}")# 0print(f"秒数部分:{diff.seconds}")# 30600print(f"总秒数:{diff.total_seconds()}")# 30600.0

6. 实用示例

6.1 倒计时

fromdatetimeimportdatetime,timedeltadefcountdown(target_date):"""计算倒计时"""now=datetime.now()remaining=target_date-nowifremaining.total_seconds()<=0:return"时间已到！"days=remaining.days hours=remaining.seconds//3600minutes=(remaining.seconds%3600)//60seconds=remaining.seconds%60returnf"剩余:{days}天{hours}小时{minutes}分钟{seconds}秒"# 示例：距离2027年元旦target=datetime(2027,1,1,0,0,0)print(countdown(target))

6.2 超时判断

fromdatetimeimportdatetime,timedeltadefis_timeout(start_time,timeout_seconds):"""判断是否超时"""elapsed=datetime.now()-start_timereturnelapsed.total_seconds()>timeout_seconds# 示例start=datetime.now()# 模拟耗时操作importtime time.sleep(2)ifis_timeout(start,1):print("操作超时！")else:print("操作完成")

6.3 日期范围生成器

fromdatetimeimportdate,timedeltadefdate_range(start_date,end_date):"""生成日期范围"""current=start_datewhilecurrent<=end_date:yieldcurrent current+=timedelta(days=1)# 示例start=date(2026,4,1)end=date(2026,4,7)fordindate_range(start,end):print(d.strftime("%Y-%m-%d %A"))

6.4 时间格式化

fromdatetimeimporttimedeltadefformat_duration(td):"""格式化时间差为可读字符串"""days=td.days hours=td.seconds//3600minutes=(td.seconds%3600)//60seconds=td.seconds%60parts=[]ifdays>0:parts.append(f"{days}天")ifhours>0:parts.append(f"{hours}小时")ifminutes>0:parts.append(f"{minutes}分钟")ifseconds>0ornotparts:parts.append(f"{seconds}秒")return" ".join(parts)# 示例td=timedelta(days=5,hours=3,minutes=30,seconds=15)print(format_duration(td))# 5天 3小时 30分钟 15秒

6.5 工作日计算

fromdatetimeimportdate,timedeltadefadd_workdays(start_date,days):"""添加工作日（跳过周末）"""current=start_date added=0whileadded<days:current+=timedelta(days=1)ifcurrent.weekday()<5:# 周一到周五added+=1returncurrentdefworkdays_between(start_date,end_date):"""计算两个日期之间的工作日数"""days=0current=start_datewhilecurrent<=end_date:ifcurrent.weekday()<5:days+=1current+=timedelta(days=1)returndays# 示例start=date(2026,4,1)end=date(2026,4,30)print(f"4月工作日数:{workdays_between(start,end)}")print(f"从4月1日加10个工作日:{add_workdays(start,10)}")

7. 完整示例

fromdatetimeimportdatetime,timedelta,dateprint("="*50)print("timedelta 类综合示例")print("="*50)# 1. 创建 timedeltaprint("\n1. 创建 timedelta")td1=timedelta(days=5)td2=timedelta(hours=3,minutes=30)td3=timedelta(weeks=2)print(f"5天:{td1}")print(f"3.5小时:{td2}")print(f"2周:{td3}")# 2. 运算print("\n2. timedelta 运算")print(f"加法:{td1+td2}")print(f"乘法:{td1*3}")print(f"总秒数:{td2.total_seconds()}秒")# 3. 与 datetime 结合print("\n3. 与 datetime 结合")now=datetime.now()future=now+timedelta(days=30)past=now-timedelta(days=7)print(f"现在:{now}")print(f"30天后:{future}")print(f"7天前:{past}")# 4. 时间差print("\n4. 时间差计算")start=datetime(2026,4,19,9,0,0)end=datetime(2026,4,19,17,30,0)diff=end-startprint(f"工作时长:{diff}")print(f"总分钟:{diff.total_seconds()/60:.0f}分钟")# 5. 实用功能print("\n5. 实用功能")today=date.today()week_later=today+timedelta(weeks=1)print(f"一周后:{week_later}")print(f"一周后是星期:{week_later.strftime('%A')}")

8. 常见陷阱

9. 总结