Python / 知识点

Python 开发速查手册

手册条目

创建、解析、格式化和计算日期时间值。

Python 日期与时间速查

用于创建固定日期、解析字符串、格式化输出和计算时间间隔。优先使用 datetime、date 和 timedelta,业务代码不要用字符串直接做日期比较或加减。

基本语法

date 只表示年月日,datetime 表示日期和时间,timedelta 表示一段时长。解析固定格式文本用 datetime.strptime(),输出给程序交换时优先用 isoformat()。

python
from datetime import date, datetime, timedelta

def main() -> None:
    report_day = date(2026, 8, 5)
    started_at = datetime.strptime(
        "2026-08-05 17:30:00",
        "%Y-%m-%d %H:%M:%S",
    )

    # 日期和时间间隔可以直接相加;结果仍保持原来的类型。
    next_day = report_day + timedelta(days=1)
    expires_at = started_at + timedelta(hours=2, minutes=15)

    print(report_day.isoformat())
    print(started_at.strftime("%Y/%m/%d %H:%M"))
    print(next_day.isoformat())
    print(expires_at.isoformat(sep=" "))
    print((expires_at - started_at).total_seconds())

if __name__ == "__main__":
    main()

预期输出:

text
2026-08-05
2026/08/05 17:30
2026-08-06
2026-08-05 19:45:00
8100.0

最后一行是秒数;需要整数时可在确认不会丢失小数后使用 int()。

高频用法

  • 读取 ISO 8601 文本:datetime.fromisoformat("2026-08-05T17:30:00")。
  • 获取当前本地时间:datetime.now();只在明确接受“无时区时间”时使用。
  • 计算截止时间:起始时间加 timedelta,不要手动处理跨月、闰年或月底。
  • 比较先后:直接比较同类型的 date,或比较时区状态一致的 datetime。

常用格式指令

指令 含义 示例
%Y 四位年份 2026
%m 两位月份 08
%d 两位日期 05
%H:%M:%S 24 小时时分秒 17:30:00
%z UTC 偏移 +0800

解析失败会抛出 ValueError。外部输入应先确定唯一格式;同时接受多种格式时,按明确顺序逐个尝试并记录最终命中的格式。

风险与边界

当 datetime 没有 tzinfo 时,它是无时区时间。若把它当作 UTC 或本地时间跨系统传递,可能整体偏移数小时。安全做法是:纯日历日期使用 date;真实时间点使用带时区的 datetime,并在存储或接口中采用 ISO 8601。

timedelta.days 只返回整天部分,可能忽略不足一天的秒数。计算总秒数应使用 total_seconds();计算自然月或自然年不能用固定 30 天或 365 天替代,应按业务日历单独处理。

排障清单与兼容性

  • 出现 ValueError: time data ... does not match format:逐字符核对分隔符、位数和格式指令。
  • 比较时报 can't compare offset-naive and offset-aware datetimes:统一转换为带时区时间,不要删除 tzinfo 逃避错误。
  • 结果差一天:检查是否把 datetime 截断成 date,或在跨时区转换前先取了日期。
  • datetime.fromisoformat() 适合标准 ISO 8601 输入;非常规文本应使用明确的 strptime() 格式。

速查原则:日期用 date,时间点用带时区的 datetime,时长用 timedelta。

目录与阅读设置

记录一个想法

Python 开发速查手册

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通