Python | datetime库函数的详解

datetime 是 Python 内置的日期时间处理库，它包含了处理日期、时间、时间间隔等的类和函数。datetime 库可以从系统中获得时间，并以用户选择的格式输出。下面是 datetime 常用的类和函数以及它们的详细解释。

datetime 类

datetime 类是 date 和 time 两个类的结合体，表示一个具体的日期和时间。

class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

• year: 年份，四位数。例如：2021。
• month: 月份，1~12 之间的整数。
• day: 日，1~31 之间的整数。
• hour: 小时，0~23 之间的整数。
• minute: 分钟，0~59 之间的整数。
• second: 秒，0~59 之间的整数。
• microsecond: 微秒，0~999999 之间的整数。
• tzinfo: 时区信息，如果不指定则表示本地时区。
• fold: 用于处理 DST（夏令时）的标记，0 表示未折叠，1 表示已折叠。

下面是 datetime 类的一些常用方法：

• datetime.today() 和 datetime.now(): 返回当前日期和时间。
• datetime.date(): 返回日期部分。
• datetime.time(): 返回时间部分。
• datetime.timestamp(): 将 datetime 对象转换为 Unix 时间戳。
• datetime.strftime(): 将 datetime 对象格式化为字符串。
• datetime.strptime(): 将字符串解析为 datetime 对象。

date 类

date 类表示一个日期，不包含时间信息。

class datetime.date(year, month, day)

• year: 年份，四位数。例如：2021。
• month: 月份，1~12 之间的整数。
• day: 日，1~31 之间的整数。

下面是 date 类的一些常用方法：

• date.today(): 返回当前日期。
• date.fromisoformat(): 将 ISO 格式字符串转换为 date 对象。
• date.toordinal(): 将 date 对象转换为 Gregorian 日历下的序数。
• date.weekday(): 返回星期几，0 表示星期一，6 表示星期日。
• date.strftime(): 将 date 对象格式化为字符串。
• date.fromtimestamp(): 将 Unix 时间戳转换为 date 对象。

time 类

time 类表示一个时间，不包含日期信息。

class datetime.time(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, *, fold=0)

• hour: 小时，0~23 之间的整数。
• minute: 分钟，0~59 之间的整数。
• second: 秒，0~59 之间的整数。
• microsecond: 微秒，0~999999 之间的整数。
• tzinfo: 时区信息，如果不指定则表示本地时区。
• fold: 用于处理 DST（夏令时）的标记，0 表示未折叠，1 表示已折叠。

下面是 time 类的一些常用方法：

• time.fromisoformat(): 将 ISO 格式字符串转换为 time 对象。
• time.strftime(): 将 time 对象格式化为字符串。
• time.fromtimestamp(): 将 Unix 时间戳转换为 time 对象。

timedelta 类

timedelta 类表示两个日期或时间之间的时间间隔。

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

• days: 天数，可以为负数。
• seconds: 秒数，可以为负数。
• microseconds: 微秒数，可以为负数。
• milliseconds: 毫秒数，可以为负数。
• minutes: 分钟数，可以为负数。
• hours: 小时数，可以为负数。
• weeks: 周数，可以为负数。

下面是 timedelta 类的一些常用方法：

• timedelta.total_seconds(): 返回时间间隔的总秒数。
• timedelta.days: 返回天数。
• timedelta.seconds: 返回秒数，不包括天数。
• timedelta.microseconds: 返回微秒数，不包括天数和秒数。

其他函数

除了上述类之外，datetime 模块还提供了一些其他函数，如下所示：

• datetime.datetime.strptime(date_string, format): 将字符串解析为 datetime 对象。
• datetime.datetime.combine(date, time): 将 date 对象和 time 对象组合为 datetime 对象。
• datetime.datetime.now(tz=None): 返回当前日期和时间，可以指定时区。
• datetime.datetime.utcnow(): 返回当前 UTC 时间。
• datetime.datetime.fromtimestamp(timestamp, tz=None): 将 Unix 时间戳转换为 datetime 对象，可以指定时区。
• datetime.datetime.fromordinal(ordinal): 将 Gregorian 日历下的序数转换为 datetime 对象。
• datetime.datetime.fromisoformat(date_string): 将 ISO 格式字符串转换为 datetime 对象。
• datetime.date.today(): 返回当前日期。
• datetime.date.fromtimestamp(timestamp): 将 Unix 时间戳转换为 date 对象。
• datetime.date.fromisoformat(date_string): 将 ISO 格式字符串转换为 date 对象。
• datetime.time.fromisoformat(time_string): 将 ISO 格式字符串转换为 time 对象。

以上是 datetime 模块中一些常用的类和函数，可以方便地进行日期时间的处理和转换。

strftime() 方法

datetime.strftime()作用: 将 datetime 对象格式化为字符串。

strftime() 方法是时间格式化最有效的方法，几乎可以以任何通用格式输出时间。例如下面的例子，用该方法输出特定格式时间。

from datetime import datetime
today = datetime.now()
print(today.strftime("%Y-%m-%d %H : %M : %S"))

# 执行结果
2023-07-03 08 : 49 : 40

下表是 strftime() 方法的格式化控制符：

格式化字符串	日期/时间	值范围和实例
%Y	年份	0001~9999
%m	月份	01~12
%B	月名	January~December
%b	月名缩写	Jan~Dec
%d	日期	01~31
%A	星期	Monday~Sunday
%a	星期缩写	Mon~Sun
%H	小时（24 h 制）	00~23
%M	分钟	00~59
%S	秒	00~59
%x	日期	月/日/年，例如，01/01/2022
%X	时间	时 ：分：秒，例如，19 : 09 : 31

strftime() 格式化字符串的数字左侧会自动补零，上述格式也可以与 print() 的格式化函数起使用，例如:

from datetime import datetime

now = datetime.now()

print(now.strftime("%Y- %m- %d")) # 2023- 07- 03
print(now.strftime('%A, %d. %B %Y %H : %M%p')) # Monday, 03. July 2023 10 : 05AM
ft = now.strftime('%Y{y}%m{m}%d{d} %H{h}%M{f}%S{s}').format(y='年', m='月', d='日', h='时', f='分', s='秒')
print(ft) # 2023年07月03日 10时02分54秒
print("今天是 {0:%Y} 年 {0:%m} 月 {0:%d} 日".format(now)) # 今天是 2023 年 07 月 03 日