Python datetime 模块
Python 的 datetime 模块是用于处理日期和时间的标准库模块。它提供了多种类和函数,可以帮助我们轻松地处理日期、时间、时间差等操作。无论是获取当前时间、格式化日期,还是计算时间差,datetime 模块都能胜任。
datetime 模块的核心类
datetime 模块中包含了以下几个核心类:
date 类 - date 类用于表示日期,包含年、月、日三个属性。
time 类 - time 类用于表示时间,包含时、分、秒、微秒等属性。
datetime 类 -datetime 类是 date 和 time 的结合体,可以同时表示日期和时间。
timedelta 类 - timedelta 类用于表示时间差,可以用于日期和时间的加减操作。
使用 datetime 模块
获取当前日期和时间
我们可以使用 datetime 类的 now() 方法来获取当前的日期和时间。
实例
from datetime import datetime
# 获取当前日期和时间
now = datetime.now()
print("当前时间:", now)
输出示例:
当前时间: 2025-04-22 14:30:45.123456
创建特定的日期和时间
我们可以通过 datetime 类的构造函数来创建特定的日期和时间。
实例
from datetime import datetime
# 创建特定的日期和时间
specific_time = datetime(2025, 4, 22, 15, 30, 0)
print("特定时间:", specific_time)
输出示例:
特定时间: 2025-04-22 15:30:00
格式化日期和时间
datetime 对象可以通过 strftime() 方法格式化为字符串。
实例
from datetime import datetime
# 获取当前时间
now = datetime.now()
# 格式化输出
formatted_time = now.strftime("%Y-%m-%d %H:%M:%S")
print("格式化时间:", formatted_time)
输出示例:
格式化时间: 2025-04-22 14:30:45
计算时间差
timedelta 类可以用于计算两个日期或时间之间的差值。
实例
from datetime import datetime, timedelta
# 获取当前时间
now = datetime.now()
# 计算 10 天后的时间
future_time = now + timedelta(days=10)
print("10 天后的时间:", future_time)
输出示例:
10 天后的时间: 2025-05-02 14:30:45.123456
常见应用场景
计算两个日期之间的天数
实例
from datetime import date
# 创建两个日期
date1 = date(2025, 4, 22)
date2 = date(2025, 5, 1)
# 计算天数差
delta = date2 - date1
print("两个日期之间的天数差:", delta.days)
输出示例:
两个日期之间的天数差: 9
处理时区
datetime 模块本身不直接支持时区操作,但可以通过 pytz 库来处理时区。
实例
from datetime import datetime
import pytz
# 获取当前时间并设置时区
now = datetime.now(pytz.timezone('Asia/Shanghai'))
print("上海当前时间:", now)
输出示例:
上海当前时间: 2025-04-22 14:30:45.123456+08:00
常用类、方法及属性
1. 核心类
类
说明
示例
datetime.date
日期类(年、月、日)
date(2023, 5, 15)
datetime.time
时间类(时、分、秒、微秒)
time(14, 30, 0)
datetime.datetime
日期时间类(包含日期和时间)
datetime(2023, 5, 15, 14, 30)
datetime.timedelta
时间间隔类(用于日期/时间计算)
timedelta(days=5)
datetime.tzinfo
时区信息基类(需子类化实现)
自定义时区类
2. date 对象常用方法/属性
方法/属性
说明
示例
date.today()
返回当前本地日期
date.today() → date(2023, 5, 15)
date.fromisoformat(str)
从 YYYY-MM-DD 字符串解析日期
date.fromisoformat("2023-05-15")
date.year
年份(只读)
d.year → 2023
date.month
月份(1-12,只读)
d.month → 5
date.day
日(1-31,只读)
d.day → 15
date.weekday()
返回星期几(0=周一,6=周日)
d.weekday() → 0
date.isoformat()
返回 YYYY-MM-DD 格式字符串
d.isoformat() → "2023-05-15"
date.strftime(format)
自定义格式化输出
d.strftime("%Y/%m/%d") → "2023/05/15"
3. time 对象常用方法/属性
方法/属性
说明
示例
time.hour
小时(0-23,只读)
t.hour → 14
time.minute
分钟(0-59,只读)
t.minute → 30
time.second
秒(0-59,只读)
t.second → 0
time.microsecond
微秒(0-999999,只读)
t.microsecond → 0
time.isoformat()
返回 HH:MM:SS.mmmmmm 格式字符串
t.isoformat() → "14:30:00"
time.strftime(format)
自定义格式化输出
t.strftime("%H:%M") → "14:30"
4. datetime 对象常用方法/属性
方法/属性
说明
示例
datetime.now()
返回当前本地日期时间
datetime.now() → datetime(2023, 5, 15, 14, 30, 0)
datetime.utcnow()
返回当前 UTC 日期时间
datetime.utcnow()
datetime.fromtimestamp(ts)
从时间戳创建 datetime 对象
datetime.fromtimestamp(1684146600)
datetime.timestamp()
返回时间戳(浮点数秒)
dt.timestamp() → 1684146600.0
datetime.date()
提取日期部分
dt.date() → date(2023, 5, 15)
datetime.time()
提取时间部分
dt.time() → time(14, 30)
datetime.year
年份(同 date)
dt.year → 2023
datetime.strftime(format)
自定义格式化输出
dt.strftime("%Y-%m-%d %H:%M") → "2023-05-15 14:30"
5. timedelta 对象常用属性
属性
说明
示例
days
天数(可正可负)
delta.days → 5
seconds
秒数(0-86399)
delta.seconds → 3600(1小时)
microseconds
微秒数(0-999999)
delta.microseconds → 0
6. 常用格式化符号(strftime)
符号
说明
示例输出
%Y
四位年份
2023
%m
两位月份(01-12)
05
%d
两位日(01-31)
15
%H
24小时制小时(00-23)
14
%M
分钟(00-59)
30
%S
秒(00-59)
00
%A
完整星期名
Monday
%a
缩写星期名
Mon
%B
完整月份名
May
%b
缩写月份名
May
实例
1. 计算日期差
实例
from datetime import date, timedelta
d1 = date(2023, 5, 15)
d2 = date(2023, 6, 1)
delta = d2 - d1 # 返回 timedelta 对象
print(delta.days) # 输出: 17
2. 时间加减
实例
from datetime import datetime, timedelta
now = datetime.now()
future = now + timedelta(days=3, hours=2)
print(future.strftime("%Y-%m-%d %H:%M"))
3. 时区转换(需安装 pytz)
实例
from datetime import datetime
import pytz
utc_time = datetime.utcnow().replace(tzinfo=pytz.utc)
beijing_time = utc_time.astimezone(pytz.timezone("Asia/Shanghai"))
print(beijing_time)
4. 解析字符串
实例
from datetime import datetime
dt = datetime.strptime("2023-05-15 14:30", "%Y-%m-%d %H:%M")
print(dt.year) # 输出: 2023
注意事项
不可变性:所有 datetime 对象不可变,操作会返回新对象。
时区处理:原生 datetime 无时区支持,需用 pytz 或 Python 3.9+ 的 zoneinfo。
性能:频繁创建对象可能影响性能,考虑重用或缓存。
边界检查:非法日期(如 date(2023, 2, 30))会触发 ValueError。