Python 日期与时间处理实战:基于 c9-python-getting-started 课程的 datetime 模块指南

原创2026-10-14 09:11:401,899 阅读
文章标签:示例工程

Python 日期与时间处理实战:基于 c9-python-getting-started 课程的 datetime 模块指南

本篇技术指南围绕 c9-python-getting-started 仓库中《06 - Dates》课程展开,系统讲解 Python 标准库 datetime 模块的四大核心类型(date、time、datetime、timedelta),并结合仓库内的 date_functions.py、format_date.py、input_date.py 等示例代码,带你掌握获取当前日期时间、拆分日期成分、日期加减运算、字符串与日期对象互转等实战技能。学完本节,你将能够独立完成日期类数据的读取、解析、计算与格式化,为后续开发(如日志时间戳、数据报表、日程计算)打下基础。

datetime 模块:Python 处理日期与时间的核心工具箱

datetime 是 Python 标准库中用于操纵日期和时间的模块,无需安装任何第三方包,直接 import 即可使用。正如课程 README 所述,它包含多个用于处理日期和时间的类(classes),其中最常用的是以下四种类型:

类型 存储内容 典型用途
date 年(year)、月(month)、日(day) 表示某一天,如生日、节假日
time 时(hour)、分(minute)、秒(second) 表示一天中的某个时刻,不关心日期
datetime 年、月、日、时、分、秒 同时携带日期与时间,是最常用的完整时间戳类型
timedelta 两个日期/时间/datetime 之间的时间跨度(时长) 日期加减、时间差计算

timedelta 与前三种类型不同:它不表示"某个时刻",而是表示"一段时长",例如"1 天"、"1 周"。正是这种设计,使得两个 datetime 对象相减可以得到 timedelta,而 datetime 与 timedelta 相加减则可以得到新的 datetime。

在仓库示例中,导入语句通常写作(见 date_functions.py):

from datetime import datetime, timedelta

课程配套幻灯片位于 python-for-beginners/Slides/6 - Dates.pptx,可作为视频学习时的同步参考。

获取当前日期与时间:datetime.now()

在程序中获取"现在是什么时间"是日期处理最基础的需求。datetime 类提供了 now() 函数,返回当前日期和时间的 datetime 对象。仓库中的 get_current_date.py 完整演示了这一用法:

# 要获取当前日期和时间,我们需要使用 datetime 库
from datetime import datetime

current_date = datetime.now()
# now 函数返回当前日期和时间,类型为 datetime 对象

# 必须先把 datetime 对象转换为字符串,
# 才能将其与其他字符串拼接
print('Today is: ' + str(current_date))

这里有两个关键细节值得注意:

  1. datetime.now() 返回的是 datetime 对象,而不是字符串。直接打印它虽然能输出类似 2026-10-14 00:40:44.123456 的可读文本,但当你需要把它与普通字符串拼接时,必须先用 str() 显式转换。
  2. 字符串拼接的隐式转换陷阱:Python 中 'Today is: ' + current_date 会直接抛出 TypeError: can only concatenate str (not "datetime.datetime") to str,因为 + 运算符不会自动把对象转成字符串。示例代码中的 str(current_date) 正是为了规避这一错误。

拆分日期时间的组成成分:day、month、year、hour、minute、second

拿到一个 datetime 对象后,如果只需要其中某一部分(比如只要年份,或只要小时),可以直接访问其属性。仓库中的 format_date.py 演示了如何把日期时间拆分成各个组成部分:

# 要获取当前日期和时间,我们需要使用 datetime 库
from datetime import datetime

# now 函数返回当前日期和时间
today = datetime.now()

# 使用 day、month、year、hour、minute、second 函数
# 来只显示日期中的某一部分
# 所有这些函数返回的都是整数
# 在把它们拼接到其他字符串之前,必须先转换成字符串
print('Day: ' + str(today.day))
print('Month: ' + str(today.month))
print('Year: ' + str(today.year))

print('Hour: ' + str(today.hour))
print('Minute: ' + str(today.minute))
print('Second: ' + str(today.second))

运行后输出形如:

Day: 14
Month: 10
Year: 2026
Hour: 0
Minute: 40
Second: 44

注意源码注释中的提示:day、month、year、hour、minute、second 返回的都是整数(integer),因此在与其他字符串拼接前必须使用 str() 转换,这与上一节 datetime 对象需要转字符串是同一类问题。如果你想得到两位数的月份(如 10 而非 10,或 03 而非 3),仅靠属性访问是不够的,需要借助格式化函数(见下文 strftime),或使用 f'{today.month:02d}' 这类格式化语法。

timedelta:日期的加减运算

timedelta 是日期运算的核心工具。仓库中的 date_functions.py 演示了如何计算"昨天"和"上周":

# 要获取当前日期和时间,我们需要使用 datetime 库
from datetime import datetime, timedelta

# now 函数返回当前日期和时间
today = datetime.now()

print('Today is: ' + str(today))

# 你可以使用 timedelta 来给日期加或减若干天、若干周
one_day = timedelta(days=1)
yesterday = today - one_day
print('Yesterday was: ' + str(yesterday))

one_week = timedelta(weeks=1)
last_week = today - one_week
print('Last week was: ' + str(last_week))

该示例展示了 timedelta 的两个典型用法:

  • 构造时长:timedelta(days=1) 表示 1 天的时长,timedelta(weeks=1) 表示 1 周的时长。timedelta 还支持 hours、minutes、seconds、milliseconds、microseconds 等参数,也可同时传入多个参数,如 timedelta(days=2, hours=3)。
  • 日期相减:datetime 对象减去 timedelta 得到更早的 datetime,加上 timedelta 则得到更晚的 datetime(这一加法用法在 code_challenge_solution.py 中可以看到:one_week_later = date_entered + one_week)。

此外,两个 datetime 对象之间也可以直接相减得到 timedelta,这正是"时间差"语义的体现——例如用 date2 - date1 就能算出两个日期相隔多少天。

字符串转日期:strptime 与日期格式码

程序经常需要把用户输入或文件中的日期字符串转换成真正的日期对象,以便进行运算。datetime 类提供了 strptime()(string parse time)函数来完成这一转换。仓库中的 input_date.py 给出了完整的实战示例:

# 导入 datetime 和 timedelta 模块
from datetime import datetime, timedelta

# 当你向用户询问日期时,务必告诉对方期望的日期格式
birthday = input('When is your birthday (dd/mm/yyyy)? ')

# 当把包含日期的字符串转换成日期对象时,
# 你必须指定期望的日期格式
# 如果日期不符合期望格式,Python 会抛出异常
birthday_date = datetime.strptime(birthday, '%d/%m/%Y')

print('Birthday: ' + str(birthday_date))

# 因为我们已经把字符串转换成了日期对象,
# 就可以对对象使用 timedelta 等日期和时间函数
one_day = timedelta(days=1)
birthday_eve = birthday_date - one_day
print('Day before birthday: ' + str(birthday_eve))

strptime 的用法要点:

  1. 第一个参数是要解析的字符串(如 '14/10/2026'),第二个参数是描述该字符串结构的格式码(format code)字符串。
  2. 格式码必须与输入字符串完全对应:'%d/%m/%Y' 表示"日/月/年",其中 %d 是两位日期(01–31),%m 是两位月份(01–12),%Y 是四位年份(如 2026)。
  3. 解析失败会抛出异常:如果用户输入的字符串不符合指定格式,Python 会抛出 ValueError。这解释了示例代码注释中的提醒——所以一方面要在输入提示语中明确告知格式(如 (dd/mm/yyyy)),另一方面在实际应用中通常应配合 try/except 处理异常输入。

课程 README 同时指向了 strptime 与 strftime 的对照行为说明。与 strptime(字符串 → 日期对象)相反,strftime(string format time)用于把日期对象格式化为指定格式的字符串,例如 today.strftime('%d/%m/%Y') 可以得到 '14/10/2026'。两者共享同一套格式码,常用格式码包括:

格式码 含义 示例
%d 月份中的第几天(01–31) 14
%m 月份(01–12) 10
%Y 四位年份 2026
%y 两位年份(00–99) 26
%H 小时(00–23,24 小时制) 00
%M 分钟(00–59) 40
%S 秒(00–59) 44
%B 完整月份名称 October
%b 缩写月份名称 Oct
%A 完整星期名称 Wednesday
%a 缩写星期名称 Wed

遵守 PEP-8:为日期变量命名

课程 README 特别强调:为变量命名时应遵循 PEP-8 风格指南(Style Guide for Python Code) 中的命名约定。对日期处理代码而言,主要体现在两点:

  • 变量名使用小写字母加下划线的 snake_case 风格,而不是驼峰式(camelCase)或大写字母;
  • 变量名应具有描述性,能直接说明变量承载的内容。

仓库示例本身就是很好的范本:today(今天)、current_date(当前日期)、birthday(生日字符串)、birthday_date(生日日期对象)、one_day(一天的时长)、one_week(一周的时长)、last_week(上周)等命名,都是既简洁又能自解释的 snake_case 命名。这种命名习惯让代码可读性大幅提升,也是后续学习更复杂 Python 项目时应当坚持的规范。

实战演练:完成日期处理编码挑战

每个课程小节都配有编码挑战,本节也不例外。仓库中的 code_challenge.py 给出了任务清单:

# 打印今天的日期
# 打印昨天的日期
# 请用户输入一个日期
# 打印距离该输入日期一周之后的日期

完整参考答案在 code_challenge_solution.py,它把前面所有知识点串联了起来:

from datetime import datetime, timedelta

# 打印今天的日期
current_date = datetime.now()
print(current_date)

# 打印昨天的日期
one_day = timedelta(days=1)
yesterday = current_date - one_day
print('Yesterday was: ' + str(yesterday))

# 请用户输入一个日期
date_entered = input('Please enter a date (dd/mm/yyyy): ')
date_entered = datetime.strptime(date_entered, '%d/%m/%Y')

# 打印距离该输入日期一周之后的日期
one_week = timedelta(weeks=1)
one_week_later = date_entered + one_week
print('One week later it will be: ' + str(one_week_later))

这个答案完整覆盖了本节的四大技能点:

  1. 获取当前时间:datetime.now() 得到 current_date;
  2. 日期减法:current_date - timedelta(days=1) 得到昨天;
  3. 字符串解析:datetime.strptime(date_entered, '%d/%m/%Y') 把用户输入转换为日期对象(注意这里复用了变量名 date_entered 覆盖原字符串);
  4. 日期加法:date_entered + timedelta(weeks=1) 得到一周后的日期。

建议先独立完成挑战,再对照参考答案,重点体会"用户输入 → 字符串 → 日期对象 → 日期运算 → 字符串输出"这一完整的数据流转链路。

小结

通过本课程的学习,你已经掌握了 Python datetime 模块的核心用法:

  • 四大类型 date、time、datetime、timedelta 各自的定位与适用场景;
  • 用 datetime.now() 获取当前日期时间,并通过 str() 解决与字符串拼接的类型转换问题;
  • 通过 day、month、year、hour、minute、second 属性拆解日期时间的组成成分;
  • 用 timedelta 对日期做加减运算,计算昨天、上周、一周后等相对日期;
  • 用 strptime 配合 %d/%m/%Y 等格式码把字符串解析为日期对象,并了解 strftime 的反向格式化能力;
  • 遵循 PEP-8 的 snake_case 命名规范为日期变量命名。

这些能力是后续学习(如 even-more-python-for-beginners-data-tools 课程中的 pandas 时间序列处理、python-for-beginners/17 - JSON 中的时间戳数据读写)的重要前置基础。动手运行仓库中的示例文件,再完成编码挑战,你就能在真实代码中熟练驾驭日期与时间。

登录后查看全文
c9-python-getting-started