Python 时间与日历模块详解
time / datetime / calendar 三大模块全解析
时间处理是编程中最常见也最容易出错的地方。想想你是不是遇到过这些问题：系统日志的时间戳看不懂？考勤统计不知道怎么算加班时长？节假日排班一头雾水？别担心，Python 提供了三个强大的时间模块帮你搞定一切——time、datetime、calendar，让我们一起来学习吧！
在 Python 中，时间信息被封装成一个叫做 struct_time 的"时间元组"对象。就像一个详细的时间表，包含了年、月、日、时、分、秒、星期几、一年中的第几天等 9 个属性。
import time# 获取当前时间的 struct_time 对象current_time = time.localtime()print(current_time)# time.struct_time(tm_year=2024, tm_mon=1, tm_mday=15, tm_hour=14,# tm_min=30, tm_sec=45, tm_wday=0, tm_yday=15, tm_isdst=0)# 通过属性名访问print(f'年份: {current_time.tm_year}') # 年份: 2024print(f'月份: {current_time.tm_mon}') # 月份: 1print(f'日期: {current_time.tm_mday}') # 日期: 15print(f'小时: {current_time.tm_hour}') # 小时: 14print(f'分钟: {current_time.tm_min}') # 分钟: 30print(f'秒数: {current_time.tm_sec}') # 秒数: 45print(f'星期: {current_time.tm_wday}') # 星期: 0 (0=周一, 6=周日)print(f'一年第几天: {current_time.tm_yday}') # 一年第几天: 15print(f'夏令时: {current_time.tm_isdst}') # 夏令时: 0 (-1未知, 0不是, 1是)# 也可以通过索引访问（像元组一样）print(f'年份: {current_time[0]}') # 年份: 2024
💡 小贴士
注意 tm_wday 星期的取值是 0-6，其中 0 代表星期一，6 代表星期日。这和我们平时说的"星期一是一周的第一天"一致，但要注意不要和其他模块的星期表示搞混了！
time 模块提供了多种时间处理函数，包括获取时间戳、转换时间格式、程序休眠等，非常实用！
import time# ===== 1. time() - 获取当前时间戳（从1970年1月1日00:00:00 UTC到现在的秒数）timestamp = time.time()print(f'当前时间戳: {timestamp}') # 如: 1705296000.123456# 应用场景：日志时间戳log_timestamp = int(time.time())print(f'[LOG {log_timestamp}] 用户登录成功')# ===== 2. gmtime() - 时间戳转 UTC 时间的 struct_timeutc_time = time.gmtime()print(f'UTC 时间: {utc_time.tm_hour}:{utc_time.tm_min}')# ===== 3. localtime() - 时间戳转本地时间的 struct_timelocal_time = time.localtime()print(f'本地时间: {local_time.tm_hour}:{local_time.tm_min}')# ===== 4. mktime() - struct_time 转时间戳（反向转换）time_tuple = (2024, 2, 10, 9, 0, 0, 5, 41, 0) # 年,月,日,时,分,秒,星期,年第几天,夏令时timestamp_from_tuple = time.mktime(time_tuple)print(f'2024年2月10日9点的时间戳: {timestamp_from_tuple}')# ===== 5. asctime() - struct_time 转可读字符串print(time.asctime(local_time)) # 'Mon Jan 15 14:30:45 2024'# ===== 6. ctime() - 时间戳转可读字符串print(time.ctime(timestamp)) # 'Mon Jan 15 14:30:45 2024'# ===== 7. sleep() - 让程序暂停指定秒数print('开始工作...')time.sleep(2) # 暂停 2 秒print('工作完成！')# 应用场景：计算代码执行时间start_time = time.time()# 模拟耗时操作total = 0for i in range(1000000): total += iend_time = time.time()print(f'循环执行耗时: {end_time - start_time:.3f} 秒')
⚠️ 踩坑经验
mktime() 接收的元组顺序是：年、月、日、时、分、秒、星期、一年中的第几天、夏令时。注意：星期和一年中的第几天参数会被自动忽略，Python 会根据年月日自动计算！
strftime() 是"string format time"的缩写，可以把时间格式化成任意你想要的字符串格式。就像给时间"换衣服"，想穿什么款式都行！
import timenow = time.localtime()# 常用格式示例print(time.strftime('%Y-%m-%d', now)) # 2024-01-15 (日期)print(time.strftime('%H:%M:%S', now)) # 14:30:45 (时间)print(time.strftime('%Y-%m-%d %H:%M:%S', now)) # 2024-01-15 14:30:45 (完整时间)print(time.strftime('%Y/%m/%d', now)) # 2024/01/15 (另一种日期格式)print(time.strftime('%B %d, %Y', now)) # January 15, 2024 (英文日期)print(time.strftime('%I:%M %p', now)) # 02:30 PM (12小时制)# 应用场景：文件名加时间戳filename = f'报告_{time.strftime("%Y%m%d_%H%M%S")}.txt'print(f'生成文件名: {filename}') # 报告_20240115_143045.txt# 应用场景：日志格式log_time = time.strftime('[%Y-%m-%d %H:%M:%S]', now)print(f'{log_time} [INFO] 系统启动成功')
strftime 格式化符号对照表
💡 小贴士
最常用的格式是 '%Y-%m-%d %H:%M:%S'，记住这个就够应付 90% 的场景了！另外注意：%w 中 0 代表星期日，和 tm_wday 的 0 代表星期一不一样，千万不要搞混了！
datetime 模块是 Python 中处理时间的"瑞士军刀"，采用面向对象设计。其中 date 类专门处理日期（年、月、日），不包含时间信息。
from datetime import date# ===== 1. today() - 获取今天的日期today = date.today()print(f'今天是: {today}') # 2024-01-15print(f'年: {today.year}, 月: {today.month}, 日: {today.day}')# ===== 2. fromtimestamp() - 时间戳转日期import timetimestamp = time.time()date_from_ts = date.fromtimestamp(timestamp)print(f'时间戳转日期: {date_from_ts}')# ===== 3. min / max - 日期的最小/最大值print(f'date 最小值: {date.min}') # 0001-01-01print(f'date 最大值: {date.max}') # 9999-12-31# ===== 4. replace() - 替换日期部分birthday = date(2000, 5, 20)next_birthday = birthday.replace(year=2024)print(f'下一个生日: {next_birthday}') # 2024-05-20# ===== 5. timetuple() - 转 struct_timetime_tuple = today.timetuple()print(f'转换为元组: {time_tuple}')# ===== 6. weekday() - 获取星期几 (0=周一, 6=周日)weekday_num = today.weekday()weekdays = ['星期一', '星期二', '星期三', '星期四', '星期五', '星期六', '星期日']print(f'今天是: {weekdays[weekday_num]}')# ===== 7. isoweekday() - 获取星期几 (1=周一, 7=周日)iso_weekday = today.isoweekday()print(f'ISO 星期: {iso_weekday}')# ===== 8. isocalendar() - 返回 (年, 周数, 星期)iso_cal = today.isocalendar()print(f'ISO 日历: 第{iso_cal.year}年, 第{iso_cal.week}周, 星期{iso_cal.weekday}')# ===== 9. isoformat() - ISO 格式字符串print(f'ISO 格式: {today.isoformat()}') # 2024-01-15# ===== 10. strftime() - 自定义格式化print(today.strftime('%Y年%m月%d日')) # 2024年01月15日# 应用场景：计算生日倒计时user_birthday = date(2000, 5, 20)this_year_birthday = date(today.year, user_birthday.month, user_birthday.day)if this_year_birthday < today: this_year_birthday = this_year_birthday.replace(year=today.year + 1)days_left = (this_year_birthday - today).daysprint(f'距离生日还有 {days_left} 天！')
💡 小贴士
两个 date 对象相减会得到一个 timedelta 对象，表示时间差。可以用 .days 获取天数，非常适合做倒计时、计算间隔等！
datetime.time 类专门处理时间（时、分、秒、微秒、时区），不包含日期信息。
from datetime import time# 创建 time 对象work_start = time(9, 0, 0) # 9点上班work_end = time(18, 0, 0) # 18点下班meeting_time = time(14, 30, 0) # 14:30 开会print(f'上班时间: {work_start}') # 09:00:00print(f'下班时间: {work_end}') # 18:00:00# 属性访问print(f'时: {work_start.hour}, 分: {work_start.minute}, 秒: {work_start.second}')# ===== 1. isoformat() - ISO 格式字符串print(f'会议时间: {meeting_time.isoformat()}') # 14:30:00# ===== 2. replace() - 替换时间部分new_meeting = meeting_time.replace(hour=15, minute=0)print(f'新会议时间: {new_meeting}') # 15:00:00# ===== 3. strftime() - 自定义格式化print(work_start.strftime('%I:%M %p')) # 09:00 AM# 时间比较（可以直接用 > < ==）current_time = time(10, 30, 0)if work_start < current_time < work_end: print('现在是工作时间，好好上班！')else: print('下班啦，休息一下~')# 包含微秒的精确时间precise_time = time(12, 30, 45, 123456)print(f'精确时间: {precise_time}') # 12:30:45.123456print(f'微秒: {precise_time.microsecond}') # 123456
⚠️ 踩坑经验
注意：datetime.time 类不能直接相减！如果要计算两个时间点之间的间隔，需要先把它们加到同一个日期上变成 datetime 对象再计算。
datetime.datetime 是最常用的类，它同时包含日期和时间信息，相当于 date + time 的组合！
from datetime import datetime, timedelta# ===== 1. now() - 获取当前本地日期时间now = datetime.now()print(f'当前时间: {now}') # 2024-01-15 14:30:45.123456# ===== 2. today() - 同 now()today = datetime.today()print(f'今天: {today}')# ===== 3. utcnow() - 获取 UTC 时间utc_now = datetime.utcnow()print(f'UTC 时间: {utc_now}')# ===== 4. fromtimestamp() - 时间戳转 datetimeimport timets = time.time()dt_from_ts = datetime.fromtimestamp(ts)print(f'时间戳转: {dt_from_ts}')# ===== 5. utcfromtimestamp() - 时间戳转 UTC datetimeutc_dt = datetime.utcfromtimestamp(ts)print(f'UTC 转换: {utc_dt}')# ===== 6. combine() - date 和 time 组合成 datetimefrom datetime import date, timed = date(2024, 2, 10)t = time(9, 30, 0)dt_combined = datetime.combine(d, t)print(f'组合结果: {dt_combined}') # 2024-02-10 09:30:00# ===== 7. date() - 提取日期部分print(f'提取日期: {now.date()}') # 2024-01-15# ===== 8. time() - 提取时间部分print(f'提取时间: {now.time()}') # 14:30:45.123456# ===== timedelta - 时间差计算（计算加班时长示例）work_start = datetime(2024, 1, 15, 9, 0, 0) # 9点上班work_end = datetime(2024, 1, 15, 20, 30, 0) # 20:30下班work_duration = work_end - work_startprint(f'工作时长: {work_duration}') # 11:30:00print(f'工作小时数: {work_duration.total_seconds() / 3600:.1f} 小时')# 标准工作时间 8 小时standard_work = timedelta(hours=8)overtime = work_duration - standard_workprint(f'加班时长: {overtime}') # 3:30:00# 时间加减运算print(f'3天后: {now + timedelta(days=3)}')print(f'1周前: {now - timedelta(weeks=1)}')print(f'2小时后: {now + timedelta(hours=2)}')print(f'30分钟前: {now - timedelta(minutes=30)}')# 应用场景：打卡提醒checkin_time = datetime(now.year, now.month, now.day, 9, 0, 0)if now > checkin_time: late_minutes = int((now - checkin_time).total_seconds() / 60) print(f'⚠️ 迟到了 {late_minutes} 分钟！')else: print('✅ 按时打卡，真棒！')
💡 小贴士
timedelta 是时间差神器！支持的参数有：days, seconds, microseconds, milliseconds, minutes, hours, weeks。注意：timedelta 内部只存储 days、seconds、microseconds 三个属性，其他单位会自动转换！
calendar 模块专门处理日历相关的操作，比如判断闰年、获取某个月的日历、排班计算等，非常适合行政和HR场景！
import calendar# ===== 1. 设置每周第一天（0=周一, 6=周日）calendar.setfirstweekday(0) # 设置周一为第一天print(f'每周第一天: {calendar.firstweekday()}') # 0# ===== 2. isleap() - 判断是否是闰年print(f'2024是闰年吗? {calendar.isleap(2024)}') # Trueprint(f'2023是闰年吗? {calendar.isleap(2023)}') # False# 闰年判断规则：能被4整除但不能被100整除，或者能被400整除def is_leap(year): return (year % 4 == 0 and year % 100 != 0) or (year % 400 == 0)# ===== 3. leapdays() - 计算两个年份之间的闰年数量print(f'2000到2024之间有 {calendar.leapdays(2000, 2025)} 个闰年')# ===== 4. weekday() - 获取某一天是星期几（0=周一, 6=周日）weekday_num = calendar.weekday(2024, 2, 10)weekdays = ['周一', '周二', '周三', '周四', '周五', '周六', '周日']print(f'2024年2月10日是 {weekdays[weekday_num]}')# ===== 5. monthrange() - 获取某月第一天是星期几，以及该月有多少天# 返回 (星期几, 天数)first_day, days_in_month = calendar.monthrange(2024, 2)print(f'2024年2月第一天是 {weekdays[first_day]}，共有 {days_in_month} 天')# 应用场景：计算某个月的工作日天数workdays = 0for day in range(1, days_in_month + 1): wd = calendar.weekday(2024, 2, day) if wd < 5: # 周一到周五是工作日 workdays += 1print(f'2024年2月有 {workdays} 个工作日')# ===== 6. month() - 输出某月的日历字符串print('2024年2月日历:')print(calendar.month(2024, 2))# ===== 7. prcal() - 直接打印全年日历# calendar.prcal(2024) # 打印2024年全年日历
⚠️ 踩坑经验
注意 calendar.weekday() 返回的 0 是星期一，而 time.strftime('%w') 返回的 0 是星期日！同一个"星期几"在不同模块里编号不同，用的时候一定要测试清楚！
calendar 模块还提供了三个面向对象的类：Calendar、TextCalendar、HTMLCalendar，用于生成不同格式的日历！
import calendar# ===== 1. Calendar 类 - 迭代器方式获取日期cal = calendar.Calendar(firstweekday=0) # 周一为第一天# iterweekdays() - 获取一周每天的数字print('一周的日期编号:', list(cal.iterweekdays())) # [0, 1, 2, 3, 4, 5, 6]# itermonthdates() - 迭代某月的所有日期（包含前后月份补齐的日期）print('2024年2月的所有日期:')for date_obj in cal.itermonthdates(2024, 2): if date_obj.month == 2: # 只打印2月的日期 print(f' {date_obj}', end='')print()# ===== 2. TextCalendar 类 - 生成文本格式日历text_cal = calendar.TextCalendar(firstweekday=0)# formatmonth() - 格式化某个月print(text_cal.formatmonth(2024, 2))# formatyear() - 格式化全年（w=每个日期宽度, l=行高, c=列间距, m=列数）# print(text_cal.formatyear(2024, m=3)) # 3列显示全年# ===== 3. HTMLCalendar 类 - 生成 HTML 格式日历html_cal = calendar.HTMLCalendar(firstweekday=0)# formatmonth() - 生成某月的 HTMLmonth_html = html_cal.formatmonth(2024, 2)print('生成的 HTML 日历前200字符:')print(month_html[:200] + '...')# formatyear() - 生成全年的 HTML# year_html = html_cal.formatyear(2024)# formatyearpage() - 生成完整的 HTML 页面# year_page = html_cal.formatyearpage(2024)# 应用场景：排班表生成print('\n2024年2月排班表（周一-周五上班）:')for day in range(1, 30): try: wd = calendar.weekday(2024, 2, day) if wd < 5: status = '☀️ 上班' else: status = '🌙 休息' print(f' 2月{day}日 {weekdays[wd]}: {status}') except: break
💡 小贴士
HTMLCalendar 非常适合在网页上显示日历！你可以把生成的 HTML 嵌入到任何网页中，甚至可以继承这个类来自定义样式，给节假日标上不同的颜色，做成精美的排班日历。
三个模块各有侧重，根据场景选择最合适的工具：
| | |
|---|
| 底层 C 库接口，处理时间戳和 struct_time | ① 性能计时（代码运行时间）② 日志时间戳③ 简单的时间格式化④ 程序 sleep 暂停 |
| | ① ✅ 大多数日常场景首选② 日期时间加减（倒计时、间隔）③ 生日、纪念日提醒④ 考勤时长计算 |
| | ① 判断闰年② 生成日历（文本/HTML）③ 工作日统计、排班表④ 获取月份天数 |
💡 选择建议
一般来说，datetime 模块 是最好的选择，它功能全面且易用。只有在需要精确性能计时或底层时间戳操作时才用 time，涉及日历排班时才用 calendar。记住这三个模块可以互相转换，灵活搭配使用更高效！
时间处理是编程中最常见的需求之一。掌握了这三个模块，无论是日志记录、定时任务、考勤统计还是排班系统，你都能轻松应对！记住：选择合适的工具，让代码更简洁，让工作更高效。
10个月宝宝每天需要喝多少奶粉？