datetime、zoneinfo、calendar
datetime 模块提供日期和时间的核心操作，zoneinfo 处理时区，calendar 提供日历计算功能。
datetime | zoneinfo | calendar
tip
推荐按以下优先级选择模块：
- 日常开发：
datetime+zoneinfo - 仅需简单格式化或判断：直接用
datetime - 输出日历、判断闰年等：
calendar
datetime.date：年月日
from datetime import date
# 创建日期
d = date(2025, 12, 25)
print(d) # 2025-12-25
print(d.year, d.month, d.day) # 2025 12 25
# 获取今天
today = date.today()
print(today) # 当前日期
# 常用属性与方法
print(today.weekday()) # 0=Monday ... 6=Sunday
print(today.isoweekday()) # 1=Monday ... 7=Sunday
print(today.isoformat()) # 2025-12-01
print(today.strftime("%Y年%m月%d日")) # 2025年12月01日
datetime.time：时分秒及微秒
from datetime import time
t = time(13, 45, 30, 123456)
print(t) # 13:45:30.123456
print(t.hour, t.minute, t.second, t.microsecond)
datetime.datetime：完整日期时间
from datetime import datetime
# 创建
dt = datetime(2025, 12, 25, 13, 45, 30)
print(dt) # 2025-12-25 13:45:30
# 获取当前时间
now = datetime.now()
print(now)
# 带时区（Python 3.9+ 推荐写法）
from zoneinfo import ZoneInfo
shanghai = ZoneInfo("Asia/Shanghai")
now_sh = datetime.now(shanghai)
print(now_sh) # 2025-12-01 08:xx:xx+08:00
print(now_sh.tzname()) # CST
datetime.timedelta：时间差计算
from datetime import datetime, timedelta
now = datetime.now()
one_day = timedelta(days=1)
tomorrow = now + one_day
yesterday = now - one_day
print(f"明天: {tomorrow}")
print(f"昨天: {yesterday}")
# 各种时间间隔
print(now + timedelta(hours=3, minutes=30))
print(now + timedelta(weeks=2))
# 两个日期之间的差
from datetime import date
d1 = date(2025, 1, 1)
d2 = date(2025, 12, 31)
delta = d2 - d1
print(f"间隔 {delta.days} 天") # 间隔 364 天
datetime.timezone：固定偏移时区
from datetime import datetime, timezone, timedelta
UTC = timezone.utc
UTC8 = timezone(timedelta(hours=8), "UTC+8")
dt = datetime(2025, 1, 1, 12, 0, tzinfo=UTC8)
print(dt) # 2025-01-01 12:00:00+08:00
字符串与 datetime 互转
from datetime import datetime
# 字符串 → datetime
dt = datetime.strptime("2025-12-25 13:45", "%Y-%m-%d %H:%M")
print(dt)
# datetime → 字符串
print(dt.strftime("%Y年%m月%d日 %H:%M")) # 2025年12月25日 13:45
print(dt.isoformat()) # 2025-12-25T13:45:00
info
常用格式码：%Y 四位年、%m 月、%d 日、%H 时（24h）、%M 分、%S 秒、%f 微秒、%z 时区偏移。
zoneinfo：时区处理
Python 3.9+ 引入，基于 IANA 时区数据库，完全替代旧的 pytz。
from zoneinfo import ZoneInfo
from datetime import datetime
sh = ZoneInfo("Asia/Shanghai")
ny = ZoneInfo("America/New_York")
tk = ZoneInfo("Asia/Tokyo")
now_sh = datetime.now(sh)
print(now_sh) # 2025-12-01 08:xx:xx+08:00
print(now_sh.tzname()) # CST
print(now_sh.utcoffset()) # 8:00:00
常用时区
| 时区名称 | 说明 |
|---|---|
"Asia/Shanghai" | 中国大陆 |
"Asia/Hong_Kong" | 香港 |
"Asia/Tokyo" | 日本 |
"America/New_York" | 美东 |
"Europe/London" | 伦敦（含夏令时） |
"UTC" | 协调世界时 |
时区转换
from zoneinfo import ZoneInfo
from datetime import datetime
sh = ZoneInfo("Asia/Shanghai")
ny = ZoneInfo("America/New_York")
now_sh = datetime.now(sh)
now_ny = now_sh.astimezone(ny)
print(f"上海时间: {now_sh}")
print(f"纽约时间: {now_ny}")
tip
zoneinfo 自动处理夏令时，不要再用 pytz。
系统没有 IANA 数据库时会抛 ZoneInfoNotFoundError，安装 tzdata 包即可解决：pip install tzdata。
calendar：日历计算
所有功能均为纯计算，不涉及时区。
判断闰年
import calendar
print(calendar.isleap(2024)) # True
print(calendar.isleap(2025)) # False
# 计算两个年份之间的闰年数
print(calendar.leapdays(2000, 2025)) # 7
获取某月信息
import calendar
# 返回 (该月第一天的星期, 该月天数)
print(calendar.monthrange(2025, 2)) # (5, 28) → 2月1日是周六，共28天
# 月历矩阵（0 表示不属于当月）
print(calendar.monthcalendar(2025, 12))
# [[1, 2, 3, 4, 5, 6, 7],
# [8, 9, 10, 11, 12, 13, 14], ...]
打印日历
import calendar
# 打印某月日历
print(calendar.month(2025, 12))
# December 2025
# Mo Tu We Th Fr Sa Su
# 1 2 3 4 5 6 7
# 8 9 10 11 12 13 14
# ...
TextCalendar 与 HTMLCalendar
import calendar
# 文本日历（周一为一周开始）
cal = calendar.TextCalendar(calendar.MONDAY)
print(cal.formatmonth(2025, 12))
# 生成 HTML 日历
html_cal = calendar.HTMLCalendar(calendar.MONDAY)
html = html_cal.formatmonth(2025, 12)
print(html[:200] + "...")
实用常量
import calendar
print(calendar.MONDAY) # 0
print(calendar.SUNDAY) # 6
print(calendar.day_name[0]) # 'Monday'
print(calendar.month_name[12]) # 'December'