19 Python 标准库 datetime 模块

Python 标准库中的 datetime 模块提供了和日期和时间相关的类：

1. datetime.date 类

date 类以年、月和日表示日历中的日期，示例如下：

>>> from datetime import date
>>> date.today()
datetime.date(2020, 5, 22)
>>> d = date(2020, 5, 1)

• 从 datetime 模块中引入 date 类
• date.today() 返回表示今天的日期对象
• 构造日期 2020 年 5 月 1 日

>>> d.year
2020
>>> d.month
5
>>> d.day
1

• d.year 返回日期对象的年份
• d.month 返回日期对象的月份
• d.day 返回日期对象的日

>>> d.weekday()
4
>>> d.isoweekday()
5
>>> d.isoformat()
'2020-05-01'
>>> d.isocalendar()
(2020, 18, 5)

• d.weekday() 返回一星期中的第几天, 星期一是 0
• d.isoweekday() 返回一星期中的第几天, 星期一是 1
• d.isoformat() 以格式 YYYY-MM-DD 返回日期的字符串形式
• d.isocalendar() 返回一个元组
  • 第 0 项是年份
  • 第 1 项是这一年的第几周
  • 第 2 项是周几

>>> d.ctime()
'Fri May  1 00:00:00 2020'
>>> d.strftime("%Y-%m-%d")
'2020-05-01'

• d.ctime() 返回一个表示日期的字符串
• d.strftime() 返回指定格式的日期字符串
  • %Y 表示年份
  • %m 表示月份
  • %d 表示日

>>> e = d.replace(year=2000, month=12)
>>> e
datetime.date(2000, 12, 1)

• d.replace() 替换年份、月份、日期生成一个新日期
  • 将年份替换为 2000
  • 将月份替换为 12

2. datetime.time 类

time 类以小时、分钟和秒表示一天中的时间，示例如下：

>>> from datetime import time
>>> t = time(18, 19, 20, 21)
>>> t.hour
18
>>> t.minute
19
>>> t.second
20
>>> t.microsecond
21

• 从 datetime 模块中引入 time 类
• 构造时间 18 时 19 分 20 秒 21 微秒
  • t.hour 返回小时
  • t.minute 返回分钟
  • t.second 返回秒
  • t.microsecond 返回微秒

>>> t.isoformat()
'18:19:20.000021'
>>> t.strftime("%H:%M:%S:%f")
'18:19:20:000021'

• t.isoformat() 返回 ISO 8601 格式的时间字符串
• t.strftime() 返回指定格式的时间格式
  • %H 表示小时
  • %M 表示分钟
  • %S 表示秒
  • %f 表示微秒

>>> u = t.replace(hour=8, minute=8, second = 8)
>>> u
datetime.time(8, 8, 8, 21)  

• t.replace() 替换小时、分钟、秒生成一个新时间
  • 将小时替换为 8
  • 将分钟替换为 8
  • 将秒替换为 8

3. datetime.datetime 类

datetime 类年、月、日、小时、分钟和秒表示日期和时间，包含 date 对象和 time 对象的所有信息，示例如下：

>>> from datetime import datetime,date,time
>>> datetime.today()
datetime.datetime(2020, 5, 22, 12, 27, 34, 896212)

• 从 datetime 模块中引入类 datetime、类 date、类 time
• datetime.today() 返回表示今天的日期对象，包括年、月、日、小时、分钟、秒和微秒

>>> d = date(2020,12,12)
>>> t = time(8,8,8,8)
>>> dt = datetime.combine(d, t)
>>> dt
datetime.datetime(2020, 12, 12, 8, 8, 8, 8)

• 构造日期对象 d
• 构造时间对象 t
• datetime.combine(d, t) 将日期对象 d 和时间对象 t 组合形成一个日期时间对象 dt

>>> dt.isoformat()
'2020-12-12T08:08:08.000008'
>>> dt.strftime("%Y-%m-%d %H:%M:%S:%f")
'2020-12-12 08:08:08:000008'

• t.isoformat() 返回 ISO 8601 格式的时间字符串
• t.strftime() 返回指定格式的时间格式
  • %Y 表示年份
  • %m 表示月份
  • %d 表示日
  • %H 表示小时
  • %M 表示分钟
  • %S 表示秒
  • %f 表示微秒

>>> u = dt.replace(year=2000, hour=20)
>>> u
datetime.datetime(2000, 12, 12, 20, 8, 8, 8)
>>> u.year
2000
>>> u.hour
20

• dt.replace() 替换年、月、日、小时、分钟、秒生成一个新时间
  • 将年份替换为 2000
  • 将小时替换为 20

4. datetime.timedelta 类

timedelta 对象表示一个时间段，即两个日期 (date) 或日期时间 (datetime) 之间的差。timedelta 接受命名参数：weeks、days、hours、minutes、seconds、milliseconds、microseconds，示例如下：

>>> from datetime import date,timedelta
>>> d = date(2020,12,12)
>>> delta = timedelta(days=3)
>>> d - delta
datetime.date(2020, 12, 9)

• 从 datetime 模块中导入相关的类
• 创建日期对象 2020 年 12 月 12 日
• 创建长度为 3 天的时间段
• 日期 d 前三天的日期是 2020 年 12 月 9 日

>>> dt = datetime(2020, 12, 12, 8, 8, 8, 8)
>>> delta = timedelta(days = 3, hours = 3)
>>> dt - delta
datetime.datetime(2020, 12, 9, 5, 8, 8, 8)

• 从 datetime 模块中导入相关的类
• 创建日期对象 2020 年 12 月 12 日 8 时 8 分 8 秒 8 微秒
• 创建长度为 3 天 3 小时的时间段
• 日期 d 前 3 天 3 小时的日期是 2020 年 12 月 9 日 5 时 8 分 8 秒 8 微秒