Python Datetime 模块

Datetime 模块允许我们处理日期和时间对象。它提供了三种额外的数据类型：date、time 和 datetime。

import datetime

date()

datetime.date(year: int, month: int, day: int)

date 方法返回一个具有 year、month 和 day 属性的日期对象：

from datetime import date
# 创建一个日期对象
obj = date(2022, 12, 1)
# 访问 year 属性
obj.year

2022

obj.month

12

obj.day

1

time()

datetime.time(hour: int, minute: int, second: int)

time 方法返回一个具有 hour、minute、second、microsecond 和 tzinfo 属性的时间对象：

from datetime import time
# 创建一个时间对象
obj = time(10, 20, 33)
# 访问 hour 属性
obj.hour

10

obj.second

33

obj.microsecond

0

datetime()

datetime.datetime(year, month, day, hour, minute, second)

datetime 返回一个同时包含 date 和 time 对象属性的对象：

from datetime import datetime
# 使用日期和时间创建一个 datetime 对象
obj = datetime(2024, 12, 1, 15, 35, 59)
# 访问 year 属性
obj.year

2024

obj.month

12

obj.day

1

obj.hour

15

obj.second

59

now() 和 today()

now 和 today 方法返回一个具有系统确切日期和时间的 datetime 对象：

from datetime import datetime
# 获取当前日期和时间
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 19, 56, 49, 589806)

因为返回的对象是 datetime，我们可以同时访问 date 和 time 属性：

now.date()

datetime.date(2022, 7, 23)

now.time()

datetime.time(19, 56, 49, 589806)

now.year

2022

now.month

7

now.day

23

now.hour

19

now.minute

56

now.second

49

now.microsecond

589806

此外，now 可以接受一个 timezone 对象作为可选参数：

from datetime import datetime, timezone
# 获取当前 UTC 时间
datetime.now(timezone.utc)

datetime.datetime(2022, 7, 24, 0, 20, 8, 265634, tzinfo=datetime.timezone.utc)

如果未指定 timezone 参数，now 将默认为系统时区。

strftime() 和 strptime()

您可以使用 strftime 和 strptime 方法轻松地在字符串和 datetime 对象之间进行转换。

strftime()

strftime 允许我们从 Python datetime 对象创建人类可读的格式化字符串：

from datetime import datetime
# 获取当前 datetime 以进行格式化示例
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 20, 31, 19, 751479)

# 将 datetime 格式化为 日 - 月 (缩写)-年
now.strftime("%d-%b-%Y")

'23-Jul-2022'

# 将 datetime 格式化为 日 - 月 (数字)-年
now.strftime("%d-%m-%Y")

'23-07-2022'

# 将 datetime 格式化为 月/日/年
now.strftime("%m/%d/%Y")

'07/23/2022'

# 将 datetime 格式化为 月/日/年 - 时：分：秒
now.strftime("%b/%d/%Y - %H:%M:%S")

'Jul/23/2022 - 20:31:19'

传递给 strftime 的字符串可能看起来有点奇怪，但很容易理解其含义。例如，%m/%d/%Y 将返回用 / 分隔的月、日和年 (07/23/2022)。

strptime()

strptime 方法从字符串创建 datetime 对象。

此方法接受两个参数：

obj.strptime(datetime_string, format)

• 一个代表 datetime 对象的字符串。
• 与该字符串等效的 Python 格式代码。

from datetime import datetime

# 将字符串解析为 datetime 对象
datetime_str = '12-Jul-2023'
datetime.strptime(datetime_str, '%d-%b-%Y')

datetime.datetime(2023, 7, 12, 0, 0)

# 解析包含日期和时间的字符串
datetime_str = 'Jul/12/2023 - 14:38:37'
datetime.strptime(datetime_str, "%b/%d/%Y - %H:%M:%S")

datetime.datetime(2023, 7, 12, 14, 38, 37)

格式代码

timedelta()

timedelta 对象表示两个日期或时间之间的时间差。

from datetime import datetime

# 创建两个 datetime 对象
date_1 = datetime.strptime('12-Jul-2023', '%d-%b-%Y')
date_2 = datetime.strptime('01-Jan-2024', '%d-%b-%Y')

# 计算差异（返回 timedelta）
difference = date_2 - date_1
difference

datetime.timedelta(days=173)

# 从 timedelta 获取天数
difference.days

173

timedelta 可以向 datetime 对象添加 days、seconds 和 microseconds：

from datetime import datetime, timedelta

# 获取当前 datetime 以进行 timedelta 操作
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 21, 25, 2, 341081)

# 向当前 datetime 添加 10 天和 15 秒
now + timedelta(days=10, seconds=15)

datetime.datetime(2022, 8, 2, 21, 25, 17, 341081)

并且可以从 datetime 对象中减去 days、seconds 和 microseconds：

from datetime import datetime, timedelta

# 获取当前 datetime 以进行减法示例
now = datetime.now()
now

datetime.datetime(2022, 7, 23, 21, 25, 2, 341081)

# 从当前 datetime 减去 10 天和 15 秒
now - timedelta(days=10, seconds=15)

datetime.datetime(2022, 7, 13, 21, 59, 41, 100883)

相关链接

• 速查表：字符串格式化
• 博客：Python 数据类型
• str()
• format()
• print()