喜欢的条友记得关注、点赞、转发、收藏，你们的支持就是我最大的动力源泉。

前期基础教程：

「Python3.11.0」手把手教你安装最新版Python运行环境

讲讲Python环境使用Pip命令快速下载各类库的方法

Python启航：30天编程速成之旅（第2天）-IDE安装

【Python教程】JupyterLab 开发环境安装

Python启航：30天编程速成之旅（第17天）- 标准库（三）

datetime 是Python常用的标准库之一，提供了用于操作日期和时间的类，虽然支持日期和时间算术，但实现的重点是用于输出格式化和操作的高效属性提取。

datetime.MINYEAR 对象中允许的最小年份数，MINYEAR 为 1。

datetime.MAXYEAR 对象中允许的最大年份数，MAXYEAR 是 9999。

datetime.UTC datetime 时区单例 datetime.timezone.utc 的别名。

import datetime

print("datetime.MINYEAR:", datetime.MINYEAR)
print("datetime.MAXYEAR:", datetime.MAXYEAR)
print("datetime.UTC:", datetime.UTC)

timedelta 对象表示持续时间，即两个datetime 或 date 实例之间的差值。

class datetime.timedelta(days=0, seconds=0, microseconds=0, milliseconds=0, minutes=0, hours=0, weeks=0)类 datetime.timedelta（days=0， seconds=0， microseconds=0， milliseconds=0， minutes=0， hours=0， weeks=0）

所有参数都是可选的，默认为 0。参数可以是整数或浮点数，可以是正数或负数。

内部仅存储天数、秒数和微秒数。参数将转换为以下单位：

• 一毫秒转换为 1000 微秒。
• 一分钟转换为 60 秒。
• 一小时转换为 3600 秒。
• 一周转换为 7 天。

然后对 days、seconds 和 microseconds 进行归一化，以便 therepresentation 是唯一的，其中

• 0 <= microseconds < 1000000
• 0 <= seconds < 3600*24 (the number of seconds in one day)0 <= seconds < 3600*24（一天中的秒数）
• -999999999 <= days <= 999999999

以下示例说明了除days、seconds 和 microseconds 之外的任何参数如何被“合并”并规范化为这三个结果属性：

from datetime import timedelta
delta = timedelta(
    days=1,
    seconds=32,
    microseconds=8,
    milliseconds=32000,
    minutes=10,
    hours=18,
    weeks=3
)
delta

如果任何参数是浮点数，并且存在小数微秒，则所有参数剩余的小数微秒将合并，并且它们的总和使用四舍五入到最接近的微秒。如果没有参数是 float，则转换和规范化过程是精确的（不会丢失任何信息）。

如果 days 的规范化值超出指示范围，则会引发 OverflowError。

请注意，负值的规范化一开始可能会令人惊讶。例如：

from datetime import timedelta
d = timedelta(microseconds=-5)
(d.days, d.seconds, d.microseconds)

类属性：

timedelta.min 最小的 timedelta 对象 timedelta(-999999999)

timedelta.max 最大的 timedelta 对象 timedelta(days=999999999,hours=23, minutes=59, seconds=59, microseconds=999999)

timedelta.resolution 非相等 timedelta 对象之间可能的最小差值 timedelta(microseconds=1)

请注意，由于规范化，timedelta.max大于 -timedelta.min。-timedelta.max 不能表示为 timedelta 对象。

实例属性 （只读）：

timedelta.days 介于 -999,999,999 和 999,999,999 之间（含）。

timedelta.seconds 介于 0 和 86,399 之间（含 0 和 86,399）。

当代码实际上打算获取 total_seconds() 值时，无意中使用此属性是一个比较常见的错误：

>>>

from datetime import timedelta
duration = timedelta(seconds=24151527)
print("duration.days:", duration.days)
print("duration.seconds:", duration.seconds)
print("duration.total_seconds():", duration.total_seconds())

timedelta.microseconds 介于 0 和 999,999 之间（含 0 和 999,999）。

timedelta.total_seconds() 返回持续时间中包含的总秒数。相当于td / timedelta(seconds=1)对于秒以外的间隔单位，请直接使用除法形式（例如 td / timedelta(microseconds=1)）。

请注意，对于非常大的时间间隔（在大多数平台上大于 270 年），此方法将失去微秒级精度。

用法示例：timedelta

from datetime import timedelta
year = timedelta(days=365)
another_year = timedelta(weeks=40, days=84, hours=23,
                         minutes=50, seconds=600)
print("year == another_year:", year == another_year)
print("year:", year)
print("another_year:", another_year)
print("year.total_seconds():", year.total_seconds())

timedelta 算术示例：

from datetime import timedelta
year = timedelta(days=365)
ten_years = 10 * year
print("ten_years:", ten_years)

print("ten_years.days:", ten_years.days)

nine_years = ten_years - year
print("nine_years:", nine_years)

three_years = nine_years // 3
print("three_years:", three_years)
print("three_years.days:", three_years.days)

date.today（）：返回当前本地日期。

date.fromtimestamp(timestamp)：返回 POSIX 时间戳对应的本地日期，例如 time.time() 返回的 is。如果时间戳超出平台 C localtime() 函数支持的值范围，这可能会引发 OverflowError，并在 localtime() 失败时引发 OSError。这通常仅限于 1970 年至 2038 年。请注意，在时间戳的概念中包含闰秒的非 POSIX 系统上，fromtimestamp() 会忽略闰秒。

date.fromordinal(ordinal)：返回与公历格里高利序数对应的日期，其中 1 年的 January 1 具有序数 1。

date.fromisoformat(date_string)：

返回与以任何 validISO 8601 格式给出的date_string对应的date，但以下情况除外：

1. 当前不支持降低精度的日期 （YYYY-MMYYYY
2. 当前不支持扩展日期表示 （±YYYYYY-MM-DD）。
3. 目前不支持序数日期 （YYYY-OOO）。

例子：

from datetime import date

print(date.fromisoformat('2024-11-05'))

print(date.fromisoformat('20241105'))

print(date.fromisoformat('2024-W01-1'))

date.fromisocalendar(year, week, day)：返回与年、周和日指定的 ISO 日历日期对应的date。这是函数 date.isocalendar() 的逆函数。

date.min 最小的可表示日期 date(MINYEAR, 1, 1)

date.max 最大的可表示日期 date(MAXYEAR, 12, 31)

date.resolution 非相等日期对象之间可能的最小差值 timedelta(days=1)

实例属性 （只读）：

date.year 介于 MINYEAR 和 MAXYEAR 之间（包括 MINYEAR 和 MAXYEAR）。

date.month 介于 1 和 12 之间（含 1 和 12 之间）。

date.day 介于 1 和给定年份的给定月份的天数之间。

用法示例：date

计算事件天数的示例：

import time
from datetime import date

print("使用date.today()直接获取当前日期")
today = date.today()
print("today:", today)

print("用date.fromtimestamp()获取当前日期")
today == date.fromtimestamp(time.time())
print("today:", today)

my_birthday = date(today.year, 11, 4)
if my_birthday < today:
    my_birthday = my_birthday.replace(year=today.year + 1)

time_to_birthday = abs(my_birthday - today)
print("\n距离下一次生日还有", time_to_birthday.days, "天。")

datetime 库非常实用，功能众多，大家可以在使用过程中查看官网帮助。

datetime — Basic date and time types  Python 3.13.0 documentation

喜欢的条友记得关注、点赞、转发、收藏，你们的支持就是我最大的动力源泉。