Python 日期与时间
在 Python 中是没有原生数据类型支持时间的,日期与时间的操作需要借助三个模块,分别是 time
、datetime
、calendar
。
time
模块可以操作 C 语言库中的时间相关函数,时钟时间与处理器运行时间都可以获取。 datetime
模块提供了日期与时间的高级接口。 calendar
模块为通用日历相关函数,用于创建数周、数月、数年的周期性事件。
在学习之前,还有一些术语要补充一下,这些术语你当成惯例即可。这里在 Python 官方文档中也有相关说明,不过信息比较多,橡皮擦为你摘录必须知道的一部分。
epoch(纪元)
是时间开始的点,其值取决于平台。
对于 Unix, epoch(纪元)
是 1970年1月1日00:00:00(UTC)
。要找出给定平台上的 epoch
,请使用 time.gmtime(0)
进行查看,例如橡皮擦电脑显示:
time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=3, tm_yday=1, tm_isdst=0)
术语 纪元秒数
是指自 epoch (纪元)
时间点以来经过的总秒数,通常不包括闰秒。 在所有符合 POSIX 标准的平台上,闰秒都不会记录在总秒数中。
程序员中常把 纪元秒数
称为 时间戳
。
time 时间模块
该模块核心为控制时钟时间。
get\_clock\_info 函数
该函数获取时钟的基本信息,得到的值因不同系统存在差异,函数原型比较简单:
time.get_clock_info(name)
其中 name
可以取下述值:
monotonic
:time.monotonic()perf_counter
: time.perf\_counter()process_time
: time.process\_time()thread_time
: time.thread\_time()time
: time.time()
该函数的返回值具有以下属性:
adjustable
: 返回 True 或者 False。如果时钟可以自动更改(例如通过 NTP 守护程序)或由系统管理员手动更改,则为 True ,否则为 False ;implementation
: 用于获取时钟值的基础 C 函数的名称,就是调用底层 C 的函数;monotonic
:如果时钟不能倒退,则为 True ,否则为 False;resolution
: 以秒为单位的时钟分辨率( float )。
import time
available_clocks = [
('clock', time.clock),
('monotonic', time.monotonic),
('perf_counter', time.perf_counter),
('process_time', time.process_time),
('time', time.time),
]
for clock_name, func in available_clocks:
print('''
{name}:
adjustable : {info.adjustable}
implementation: {info.implementation}
monotonic : {info.monotonic}
resolution : {info.resolution}
current : {current}
'''.format(
name=clock_name,
info=time.get_clock_info(clock_name),
current=func()))
上图显示橡皮擦的计算机在 clock
与 perf_counter
中,调用底层 C 函数是一致的。
获取时间戳
在 Python 中通过 time.time()
函数获取纪元秒数,它可以把从 epoch
开始之后的秒数以浮点数格式返回。
import time
print(time.time())
# 输出结果 1615257195.558105
时间戳大量用于计算时间相关程序,属于必须掌握内容。
获取可读时间
时间戳主要用于时间上的方便计算,对于人们阅读是比较难理解的,如果希望获取可读时间,使用 ctime()
函数获取。
import time
print(time.ctime())
# 输出内容:Tue Mar 9 10:35:51 2021
如何将时间戳转换为可读时间,使用 localtime
函数即可。
localtime = time.localtime(time.time())
print("本地时间为 :", localtime)
输出结果为 <class 'time.struct_time'>
类型数据,后文将对其进行格式化操作:
本地时间为 : time.struct_time(tm_year=2021, tm_mon=3, tm_mday=9, tm_hour=10, tm_min=37, tm_sec=27, tm_wday=1, tm_yday=68, tm_isdst=0)
上述代码中的时间戳最小值是 0,最大值由于 Python 环境和操作系统决定,我本地 64 位操作系统进行测试的时候,得到的数据如下:
import time
localtime = time.localtime(0)
print("时间为 :", localtime)
# 时间为 : time.struct_time(tm_year=1970, tm_mon=1, tm_mday=1, tm_hour=8, tm_min=0, tm_sec=0, tm_wday=3, tm_yday=1, tm_isdst=0)
localtime = time.localtime(32536799999)
print("时间为 :", localtime)
# 时间为 : time.struct_time(tm_year=3001, tm_mon=1, tm_mday=19, tm_hour=15, tm_min=59, tm_sec=59, tm_wday=0, tm_yday=19, tm_isdst=0)
localtime = time.localtime(99999999999)
print("时间为 :", localtime)
# OSError: [Errno 22] Invalid argument
print(type(localtime))
单调时间 monotonic time
monotonic time
从系统启动开始计时,从 0 开始单调递增。
操作系统的时间可能不是从 0 开始,而且会因为时间出错而回调。
该函数原型如下,不需要任何参数,返回一个浮点数,表示小数秒内的单调时钟的值:
time.monotonic()
测试代码如下:
print("单调时间",time.monotonic())
# 输出:单调时间 12279.244
处理器时钟时间
time()
函数返回的是纪元秒数(时间戳), clock()
函数返回的是处理器时钟时间。
该函数函数的返回值:
- 在第一次调用的时候,返回的是程序运行的实际时间;
在第二次之后的调用,返回的是自第一次调用后到这次调用的时间间隔。
需要注意的是 Python 3.8 已移除
clock()
函数,用time.perf_counter()
或time.process_time()
方法替代。
t0 = time.clock()
# 运行一段代码
print(time.clock() - t0, "程序运行时间")
我使用的 Python 版本较高,提示异常如下:
time.clock has been deprecated in Python 3.3 and will be removed from Python 3.8: use time.perf_counter or time.process_time instead t0 = time.clock()
性能计数器 time.perf\_counter
perf_counter()
函数的 epoch
(纪元)是未定义的。一般使用该函数都是为了比较和计算,不是为了用作绝对时间,该点需要注意下。
该函数用于测量较短持续时间的具有最高有效精度的时钟,包括睡眠状态消耗的时间,使用两次调用才会有效。
测试代码如下:
t0 = time.perf_counter()
# 运行一段代码
for i in range(100000):
pass
print("程序运行时间", time.perf_counter() - t0)
与其类似的函数有 perf_counter_ns()
、process_time()
、process_time_ns()
,具体可以查询手册进行学习,先掌握 perf_counter()
函数即可。
时间组件
上文已经涉及了时间组件相关的知识,通过 localtime
得到的 struct_time
类型的数据。
这里涉及到的函数有 gmtime()
返回 UTC 中的当前时间,localtime()
返回当前时区对应的时间,mktime()
接收 struce_time
类型数据并将其转换成浮点型数值,即时间戳。
print("*"*10)
print(time.gmtime())
print("*"*10)
print(time.localtime())
print("*"*10)
print(time.mktime(time.localtime()))
struct\_time 类型包含的内容
上述代码返回的数据格式为:
time.struct_time(tm_year=2021, tm_mon=3, tm_mday=9, tm_hour=12, tm_min=50, tm_sec=35, tm_wday=1, tm_yday=68, tm_isdst=0)
其中各值可以根据英文含义进行理解 :tm_year
年份(range[1,12]),tm_mon
月份(range[1,12]),tm_mday
天数(range[1,31]),tm_hour
天数(range[0,23]),tm_min
分钟 (range[0,59]), tm_sec
秒数 (range[0,61]), tm_wday
星期 (range[0,6],0 是星期日), tm_yday
一年中的一天(range[1,366] ),tm_isdst
在夏令时生效时设置为 1,而在夏令时不生效时设置为 0,值-1 表示这是未知的。
9.1.8 解析和格式化时间
strptime()
和 strftime()
函数可以使时间值在 struct_time
表示和字符串表示之间相互转换。
对于 strftime
函数,其中的参数参考官方即可。
x = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
print(x)
这里的学习,没有什么难度大的点,孰能生巧的知识。
strptime 函数的应用
x = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
print(x)
# 方向操作,字符串格式化成 time.struct_time
struct_time = time.strptime(x, "%Y-%m-%d %H:%M:%S")
print(struct_time)
需要记忆的就是 strftime
与 strptime
函数只有中间的字符不同,一个是 f
,另一个是 p
。
time 小节
对于 time 模块,sleep
函数属于必备知识点,但是太常用了,你肯定已经很熟悉了。
对于模块的学习,最权威的就是官方手册了,[time 模块]
datetime 模块
该模块比 time
模块高级了很多,并且对 time
模块进行了封装,提供的功能更加强大了。
在 datetime
模块中,Python 提供了 5 个主要的对象类,分别如下:
datetime
:允许同时操作时间和日期;date
:只操作日期;time
:只操作时间;timedelta
:用于操作日期以及测量时间跨度;tzinfo
:处理时区。
date 类
优先展示部分该类的属性和方法,都是记忆层面的知识。
min
、max
:date 对象能表示的最大、最小日期;resolution
:date 对象表示日期的最小单位,返回天;today()
:返回表示当前本地日期的 date 对象;fromtimestamp(timestamp)
:根据时间戳,返回一个 date 对象。
测试代码如下:
from datetime import date
import time
print('date.min:', date.min)
print('date.max:', date.max)
print('date.resolution:', date.resolution)
print('date.today():', date.today())
print('date.fromtimestamp():', date.fromtimestamp(time.time()))
输出结果:
date.min: 0001-01-01
date.max: 9999-12-31
date.resolution: 1 day, 0:00:00
date.today(): 2021-03-09
date.fromtimestamp(): 2021-03-09
date 对象的属性和方法
通过下述代码创建一个 date 对象:
d = date(year=2021,month=3,day=9)
print(d)
该对象具备下述属性和方法:
d.year
:返回年;d.month
:返回月;d.day
:返回日;d.weekday()
:返回 weekday,如果是星期一,返回 0;如果是星期 2,返回 1,以此类推;d.isoweekday()
:返回 weekday,如果是星期一,返回 1;如果是星期 2,返回 2,以此类推;d.isocalendar()
:返回格式如(year, wk num, wk day);d.isoformat()
:返回格式如’YYYY-MM-DD’的字符串;d.strftime(fmt)
:自定义格式化字符串,与 time 模块中的 strftime 类似。
time 类
time
类定义的类属性:
min
、max
:time 类所能表示的最小、最大时间。其中,time.min = time(0, 0, 0, 0), time.max = time(23, 59, 59, 999999)
;- resolution:时间的最小单位,这里是 1 微秒;
通过其构造函数可以创建一个 time
对象。
t = time(hour=20, minute=20, second=40)
print(t)
time
类提供的实例方法和属性:
t.hour
、t.minute
、t.second
、t.microsecond
:时、分、秒、微秒;t.tzinfo
:时区信息;t.isoformat()
:返回型如”HH:MM:SS”格式的字符串时间表示;t.strftime(fmt)
:返回自定义格式化字符串。
datetime 类
该类是 date
类与 time
类的结合体,很多属性和方法前文已经介绍,再补充一些比较常用的属性和方法。
获取当前的日期与时间:
from datetime import datetime
dt = datetime.now()
print(dt)
获取时间戳:
dt = datetime.now()
# 使用 datetime 的内置函数 timestamp()
stamp = datetime.timestamp(dt)
print(stamp)
timedelta 类
通过 timedelta
函数返回一个 timedelta
时间间隔对象,该函数没有必填参数,如果写入一个整数就是间隔多少天的的意思。
# 间隔 10 天
timedelta(10)
# 跨度为1 周
timedelta(weeks=1)
两个时间间隔对象可以彼此之间相加或相减,返回的仍是一个时间间隔对象。
一个 datetime 对象如果减去一个时间间隔对象,那么返回的对应减去之后的 datetime 对象,然后两个 datetime 对象如果相减,返回的是一个时间间隔对象。
更多关于 datetime 类使用的知识,可以参考 [官方手册]。
calendar 模块(日历)
此模块的函数都是日历相关的,例如打印某月的字符月历。
calendar
模块定义了 Calendar 类,它封装了值的计算, 例如给定月份或年份中周的日期。通过 TextCalendar 和 HTMLCalendar 类可以生成预格式化的输出。
基本代码:
import calendar
c = calendar.TextCalendar(calendar.SUNDAY)
c.prmonth(2021, 3)
上述代码,默认是从周日开始的,输出结果:
March 2021
Su Mo Tu We Th Fr Sa
1 2 3 4 5 6
7 8 9 10 11 12 13
14 15 16 17 18 19 20
21 22 23 24 25 26 27
28 29 30 31
该模块使用频率较低,详细使用参考地址 。
这篇博客的总结
本篇博客为大家补充了一下时间和日期库的相关知识,希望能进入你的收藏夹。