Python datetime 模块概述

一、Python datetime 模块概述

Python的datetime模块是标准库中用于处理日期和时间的核心模块，提供了以下核心功能：

1. 日期/时间对象化：将日期、时间、日期时间等抽象为对象，支持计算和比较。
2. 格式化与解析：支持日期时间与字符串之间的双向转换。
3. 时区处理：支持本地时间和带时区的时间计算（需搭配pytz等第三方库增强）。
4. 时间运算：通过timedelta实现时间差计算，支持日期时间的加减操作。

---

二、datetime 模块核心类解析

1. date 类：处理日期（年、月、日）

• 用途：处理不含时间的纯日期。
• 关键方法：

  from datetime import date
  
  today = date.today()          # 获取当前日期
  custom_date = date(2023, 10, 1)  # 创建指定日期
  print(today.year, today.month, today.day)  # 输出：2023 10 1
  

2. time 类：处理时间（时、分、秒、微秒）

• 用途：处理不含日期的纯时间。
• 示例：

  from datetime import time
  
  t = time(14, 30, 15)  # 14:30:15
  print(t.hour, t.minute)  # 输出：14 30
  

3. datetime 类：组合日期和时间

• 核心功能：同时处理日期和时间，支持时区（需配置）。
• 常用操作：

  from datetime import datetime
  
  now = datetime.now()  # 当前本地时间
  utc_now = datetime.utcnow()  # 当前UTC时间
  dt = datetime(2023, 10, 1, 9, 30)  # 2023-10-01 09:30:00
  
  # 时间戳转换
  timestamp = dt.timestamp()  # 转为Unix时间戳
  dt_from_ts = datetime.fromtimestamp(1633068600)
  

4. timedelta 类：时间间隔计算

• 用途：表示两个时间点之间的差值。
• 示例：

  from datetime import datetime, timedelta
  
  now = datetime.now()
  future = now + timedelta(days=7, hours=3)  # 7天3小时后
  delta = future - now  # 计算时间差
  print(delta.days)  # 输出：7
  

5. tzinfo 与时区处理

• 基础时区：Python内置timezone类（需Python 3.2+）。
• 第三方库：推荐使用pytz处理复杂时区。
• 示例：

  from datetime import datetime, timezone
  import pytz
  
  # 本地时间转UTC
  local_dt = datetime(2023, 10, 1, 10, 0)
  utc_dt = local_dt.astimezone(timezone.utc)
  
  # 使用pytz处理时区
  tz_shanghai = pytz.timezone('Asia/Shanghai')
  dt_with_tz = tz_shanghai.localize(datetime(2023, 10, 1, 10, 0))
  

---

三、日期时间格式化与解析

1. strftime：日期 → 字符串

dt = datetime(2023, 10, 1, 14, 30)
formatted = dt.strftime("%Y-%m-%d %H:%M:%S")  # 输出：2023-10-01 14:30:00

2. strptime：字符串 → 日期

date_str = "2023-10-01"
dt = datetime.strptime(date_str, "%Y-%m-%d")  # 解析为datetime对象

3. 常用格式符号

---

格式符号	含义	示例
%Y	四位年份	2023
%m	两位月份	10
%d	两位日期	01
%H	24小时制小时	14
%M	分钟	30
%S	秒	45

四、典型应用场景

1. 倒计时计算：

   end_date = datetime(2023, 12, 31)
   days_left = (end_date - datetime.now()).days
   

2. 日志时间戳：

   log_time = datetime.now().strftime("[%Y-%m-%d %H:%M:%S]")
   

3. 用户输入处理：

   user_input = "2023-10-01"
   try:
       dt = datetime.strptime(user_input, "%Y-%m-%d")
   except ValueError:
       print("日期格式错误！")
   

---

五、注意事项

1. 时区敏感性：默认datetime对象是“naive”（无时区），处理跨时区需显式指定。
2. 性能优化：频繁时间计算建议使用时间戳（timestamp()）存储。
3. 闰年处理：date类自动处理闰年，如date(2024, 2, 29)有效。

若您需要更高级的时间处理功能（如自然语言解析），可参考第三方库dateutil或arrow。