python之日期与时间处理模块(date和datetime)

前言

在开发工作中,我们经常需要用到日期与时间,如:

作为日志信息的内容输出

计算某个功能的执行时间

用日期命名一个日志文件的名称

记录或展示某文章的发布或修改时间

其他

python中提供了多个用于对日期和时间进行操作的内置模块:time模块、datetime模块和calendar模块。其中time模块是通过调用c库实现的,所以有些方法在某些平台上可能无法调用,但是其提供的大部分接口与c标准库time.h基本一致。time模块相比,datetime模块提供的接口更直观、易用,功能也更加强大。

一、相关术语的解释

utc time coordinated universal time,世界协调时,又称 格林尼治天文时间、世界标准时间。与utc time对应的是各个时区的local time,东n区的时间比utc时间早n个小时,因此utc time + n小时 即为东n区的本地时间;而西n区时间比utc时间晚n个小时,即 utc time – n小时 即为西n区的本地时间; 中国在东8区,因此比utc时间早8小时,可以以utc+8进行表示。

epoch time 表示时间开始的起点;它是一个特定的时间,不同平台上这个时间点的值不太相同,对于unix而言,epoch time为 1970-01-01 00:00:00 utc。

timestamp(时间戳) 也称为unix时间 或 posix时间;它是一种时间表示方式,表示从格林尼治时间1970年1月1日0时0分0秒开始到现在所经过的毫秒数,其值为float类型。 但是有些编程语言的相关方法返回的是秒数(python就是这样),这个需要看方法的文档说明。需要说明的是时间戳是个差值,其值与时区无关。

二、时间的表现形式

常见的时间表示形式为:

时间戳

格式化的时间字符串

python中还有其它的时间表示形式:

time模块的time.struct_time

datetime模块的datetime类

关于datetime模块的datetime类会在下面做详细讲解,这里简单说下time.struct_time。

time.struct_time包含如下属性:

下标/索引属性名称描述0tm_year年份,如 20171tm_mon月份,取值范围为[1, 12]2tm_mday一个月中的第几天,取值范围为[1-31]3tm_hour小时, 取值范围为[0-23]4tm_min分钟,取值范围为[0, 59]5tm_sec秒,取值范围为[0, 61]6tm_wday一个星期中的第几天,取值范围为[0-6],0表示星期一7tm_yday一年中的第几天,取值范围为[1, 366]8tm_isdst是否为夏令时,可取值为:0 , 1 或 -1

属性值的获取方式有两种:

可以把它当做一种特殊的有序不可变序列通过 下标/索引 获取各个元素的值,如t[0]

也可以通过 .属性名 的方式来获取各个元素的值,如t.tm_year。

需要说明的是struct_time实例的各个属性都是只读的,不可修改。

三、 time模块

time模块主要用于时间访问和转换,这个模块提供了各种与时间相关的函数。

1. 函数列表

方法/属性描述time.altzone返回与utc时间的时间差,以秒为单位(西区该值为正,东区该值为负)。其表示的是本地dst 时区的偏移量,只有daylight非0时才使用。time.clock()返回当前进程所消耗的处理器运行时间秒数(不包括sleep时间),值为小数;该方法python3.3改成了time.process_time()time.asctime([t])将一个tuple或struct_time形式的时间(可以通过gmtime()和localtime()方法获取)转换为一个24个字符的时间字符串,格式为: “fri aug 19 11:14:16 2016″。如果参数t未提供,则取localtime()的返回值作为参数。time.ctime([secs])功能同上,将一个秒数时间戳表示的时间转换为一个表示当前本地时间的字符串。如果参数secs没有提供或值为none,则取time()方法的返回值作为默认值。ctime(secs)等价于asctime(localtime(secs))time.time()返回时间戳(自1970-1-1 0:00:00 至今所经历的秒数)time.localtime([secs])返回以指定时间戳对应的本地时间的 struct_time对象(可以通过下标,也可以通过 .属性名 的方式来引用内部属性)格式time.localtime(time.time() + n*3600)返回n个小时后本地时间的 struct_time对象格式(可以用来实现类似crontab的功能)time.gmtime([secs])返回指定时间戳对应的utc时间的 struct_time对象格式(与当前本地时间差8个小时)time.gmtime(time.time() + n*3600)返回n个小时后utc时间的 struct_time对象(可以通过 .属性名 的方式来引用内部属性)格式time.strptime(time_str, time_format_str)将时间字符串转换为struct_time时间对象,如:time.strptime(‘2017-01-13 17:07’, ‘%y-%m-%d %h:%m’)time.mktime(struct_time_instance)将struct_time对象实例转换成时间戳time.strftime(time_format_str, struct_time_instance)将struct_time对象实例转换成字符串

2. 练习

获取时间戳格式的时间

>>> time.time()
1486188022.862

获取struct_time格式的时间

>>> time.localtime()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=2, tm_sec=34, tm_wday=5, tm_yday=35, tm_isdst=0)
>>> time.gmtime()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=6, tm_min=2, tm_sec=56, tm_wday=5, tm_yday=35, tm_isdst=0)

获取字符串格式的时间

>>> time.ctime()
‘sat feb 04 14:06:42 2017’
>>> time.asctime()
‘sat feb 04 14:06:47 2017’

时间戳格式转struct_time格式时间

>>> t1 = time.time()
>>> print(t1)
1486188476.9
>>> t2 = time.localtime(t1)
>>> print(t2)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=7, tm_sec=56, tm_wday=5, tm_yday=35, tm_isdst=0)
>>> t3 = time.gmtime(t1)
>>> print(t3)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=6, tm_min=7, tm_sec=56, tm_wday=5, tm_yday=35, tm_isdst=0)
>>>

字符串格式转struct_time格式时间

>>> time.strptime(‘sat feb 04 14:06:42 2017’)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=6, tm_sec=42, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime(‘sat feb 04 14:06:42 2017’, ‘%a %b %d %h:%m:%s %y’)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=6, tm_sec=42, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime(‘2017-02-04 14:12’, ‘%y-%m-%d %h:%m’)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=12, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime(‘2017/02/04 14:12’, ‘%y/%m/%d %h:%m’)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=12, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> time.strptime(‘201702041412’, ‘%y%m%d%h%m’)
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=14, tm_min=12, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)

struct_time格式转字符串格式时间

>>> time.strftime(‘%y-%m-%d %h:%m’, time.localtime())
‘2017-02-04 14:19’
struct_time格式转时间戳格式时间
>>> time.mktime(time.localtime())
1486189282.0

3. 时间格式转换

时间戳格式的时间 与 字符串格式的时间 虽然可以通过ctime([secs])方法进行转换,但是字符串格式不太适应中国国情。因此,整体而言,它们 不能直接进行转换,需要通过struct_time作为中介,转换关系如下:

object
date
datetime
time
timedelta
tzinfo
timezone

2. datetime模块中定义的常量

常量名称描述datetime.minyeardatetime.date或datetime.datetime对象所允许的年份的最小值,值为1datetime.maxyeardatetime.date或datetime.datetime对象所允许的年份的最大值,只为9999

3. datetime.date类

datetime.date类的定义

class datetime.date(year, month, day)

year, month 和 day都是是必须参数,各参数的取值范围为:

参数名称取值范围year[minyear, maxyear]month[1, 12]day[1, 指定年份的月份中的天数]

类方法和属性

类方法/属性名称描述date.maxdate对象所能表示的最大日期:9999-12-31date.mindate对象所能表示的最小日志:00001-01-01date.resoluationdate对象表示的日期的最小单位:天date.today()返回一个表示当前本地日期的date对象date.fromtimestamp(timestamp)根据跟定的时间戳,返回一个date对象

对象方法和属性

对象方法/属性名称描述d.year年d.month月d.day日d.replace(year[, month[, day]])生成并返回一个新的日期对象,原日期对象不变d.timetuple()返回日期对应的time.struct_time对象d.toordinal()返回日期是是自 0001-01-01 开始的第多少天d.weekday()返回日期是星期几,[0, 6],0表示星期一d.isoweekday()返回日期是星期几,[1, 7], 1表示星期一d.isocalendar()返回一个元组,格式为:(year, weekday, isoweekday)d.isoformat()返回‘yyyy-mm-dd’格式的日期字符串d.strftime(format)返回指定格式的日期字符串,与time模块的strftime(format, struct_time)功能相同

实例

>>> import time
>>> from datetime import date
>>>
>>> date.max
datetime.date(9999, 12, 31)
>>> date.min
datetime.date(1, 1, 1)
>>> date.resolution
datetime.timedelta(1)
>>> date.today()
datetime.date(2017, 2, 4)
>>> date.fromtimestamp(time.time())
datetime.date(2017, 2, 4)
>>>
>>> d = date.today()
>>> d.year
2017
>>> d.month
2
>>> d.day
4
>>> d.replace(2016)
datetime.date(2016, 2, 4)
>>> d.replace(2016, 3)
>>> d.replace(2016, 3, 2)
datetime.date(2016, 3, 2)
>>> d.timetuple()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> d.toordinal()
736364
>>> d.weekday()
5
>>> d.isoweekday()
6
>>> d.isocalendar()
(2017, 5, 6)
>>> d.isoformat()
‘2017-02-04’
>>> d.ctime()
‘sat feb 4 00:00:00 2017’
>>> d.strftime(‘%y/%m/%d’)
‘2017/02/04’

4. datetime.time类

time类的定义

class datetime.time(hour, [minute[, second, [microsecond[, tzinfo]]]])

hour为必须参数,其他为可选参数。各参数的取值范围为:

参数名称取值范围hour[0, 23]minute[0, 59]second[0, 59]microsecond[0, 1000000]tzinfotzinfo的子类对象,如timezone类的实例

类方法和属性

类方法/属性名称描述time.maxtime类所能表示的最大时间:time(23, 59, 59, 999999)time.mintime类所能表示的最小时间:time(0, 0, 0, 0)time.resolution时间的最小单位,即两个不同时间的最小差值:1微秒

对象方法和属性

对象方法/属性名称描述t.hour时t.minute分t.second秒t.microsecond微秒t.tzinfo返回传递给time构造方法的tzinfo对象,如果该参数未给出,则返回nonet.replace(hour[, minute[, second[, microsecond[, tzinfo]]]])生成并返回一个新的时间对象,原时间对象不变t.isoformat()返回一个‘hh:mm:ss.%f’格式的时间字符串t.strftime()返回指定格式的时间字符串,与time模块的strftime(format, struct_time)功能相同

实例

>>> from datetime import time
>>>
>>> time.max
datetime.time(23, 59, 59, 999999)
>>> time.min
datetime.time(0, 0)
>>> time.resolution
datetime.timedelta(0, 0, 1)
>>>
>>> t = time(20, 5, 40, 8888)
>>> t.hour
20
>>> t.minute
5
>>> t.second
40
>>> t.microsecond
8888
>>> t.tzinfo
>>>
>>> t.replace(21)
datetime.time(21, 5, 40, 8888)
>>> t.isoformat()
’20:05:40.008888′
>>> t.strftime(‘%h%m%s’)
‘200540’
>>> t.strftime(‘%h%m%s.%f’)
‘200540.008888’

5. datetime.datetime类

datetime类的定义

代码如下:

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

year, month 和 day是必须要传递的参数, tzinfo可以是none或tzinfo子类的实例。

各参数的取值范围为:

参数名称取值范围year[minyear, maxyear]month[1, 12]day[1, 指定年份的月份中的天数]hour[0, 23]minute[0, 59]second[0, 59]microsecond[0, 1000000]tzinfotzinfo的子类对象,如timezone类的实例

如果一个参数超出了这些范围,会引起valueerror异常。

类方法和属性

类方法/属性名称描述datetime.today()返回一个表示当前本期日期时间的datetime对象datetime.now([tz])返回指定时区日期时间的datetime对象,如果不指定tz参数则结果同上datetime.utcnow()返回当前utc日期时间的datetime对象datetime.fromtimestamp(timestamp[, tz])根据指定的时间戳创建一个datetime对象datetime.utcfromtimestamp(timestamp)根据指定的时间戳创建一个datetime对象datetime.combine(date, time)把指定的date和time对象整合成一个datetime对象datetime.strptime(date_str, format)将时间字符串转换为datetime对象

对象方法和属性

对象方法/属性名称描述dt.year, dt.month, dt.day年、月、日dt.hour, dt.minute, dt.second时、分、秒dt.microsecond, dt.tzinfo微秒、时区信息dt.date()获取datetime对象对应的date对象dt.time()获取datetime对象对应的time对象, tzinfo 为nonedt.timetz()获取datetime对象对应的time对象,tzinfo与datetime对象的tzinfo相同dt.replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]])生成并返回一个新的datetime对象,如果所有参数都没有指定,则返回一个与原datetime对象相同的对象dt.timetuple()返回datetime对象对应的tuple(不包括tzinfo)dt.utctimetuple()返回datetime对象对应的utc时间的tuple(不包括tzinfo)dt.toordinal()同date对象dt.weekday()同date对象dt.isocalendar()同date独享dt.isoformat([sep])返回一个‘%y-%m-%ddt.ctime()等价于time模块的time.ctime(time.mktime(d.timetuple()))dt.strftime(format)返回指定格式的时间字符串

实例

>>> from datetime import datetime, timezone
>>>
>>> datetime.today()
datetime.datetime(2017, 2, 4, 20, 44, 40, 556318)
>>> datetime.now()
datetime.datetime(2017, 2, 4, 20, 44, 56, 572615)
>>> datetime.now(timezone.utc)
datetime.datetime(2017, 2, 4, 12, 45, 22, 881694, tzinfo=datetime.timezone.utc)
>>> datetime.utcnow()
datetime.datetime(2017, 2, 4, 12, 45, 52, 812508)
>>> import time
>>> datetime.fromtimestamp(time.time())
datetime.datetime(2017, 2, 4, 20, 46, 41, 97578)
>>> datetime.utcfromtimestamp(time.time())
datetime.datetime(2017, 2, 4, 12, 46, 56, 989413)
>>> datetime.combine(date(2017, 2, 4), t)
datetime.datetime(2017, 2, 4, 20, 5, 40, 8888)
>>> datetime.strptime(‘2017/02/04 20:49’, ‘%y/%m/%d %h:%m’)
datetime.datetime(2017, 2, 4, 20, 49)
>>> dt = datetime.now()
>>> dt
datetime.datetime(2017, 2, 4, 20, 57, 0, 621378)
>>> dt.year
2017
>>> dt.month
2
>>> dt.day
4
>>> dt.hour
20
>>> dt.minute
57
>>> dt.second
0
>>> dt.microsecond
621378
>>> dt.tzinfo
>>> dt.timestamp()
1486213020.621378
>>> dt.date()
datetime.date(2017, 2, 4)
>>> dt.time()
datetime.time(20, 57, 0, 621378)
>>> dt.timetz()
datetime.time(20, 57, 0, 621378)
>>> dt.replace()
datetime.datetime(2017, 2, 4, 20, 57, 0, 621378)
>>> dt.replace(2016)
datetime.datetime(2016, 2, 4, 20, 57, 0, 621378)
>>> dt.timetuple()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=20, tm_min=57, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=-1)
>>> dt.utctimetuple()
time.struct_time(tm_year=2017, tm_mon=2, tm_mday=4, tm_hour=20, tm_min=57, tm_sec=0, tm_wday=5, tm_yday=35, tm_isdst=0)
>>> dt.toordinal()
736364
>>> dt.weekday()
5
>>> dt.isocalendar()
(2017, 5, 6)
>>> dt.isoformat()
‘2017-02-04t20:57:00.621378′
>>> dt.isoformat(sep=’/’)
‘2017-02-04/20:57:00.621378′
>>> dt.isoformat(sep=’ ‘)
‘2017-02-04 20:57:00.621378’
>>> dt.ctime()
‘sat feb 4 20:57:00 2017’
>>> dt.strftime(‘%y%m%d %h:%m:%s.%f’)
‘20170204 20:57:00.621378’

6. 使用datetime.datetime类对时间戳与时间字符串进行转换

>>> import datetime
>>>
>>> datetime.timedelta(365).total_seconds() # 一年包含的总秒数
31536000.0
>>> dt = datetime.datetime.now()
>>> dt + datetime.timedelta(3) # 3天后
datetime.datetime(2017, 2, 8, 9, 39, 40, 102821)
>>> dt + datetime.timedelta(-3) # 3天前
datetime.datetime(2017, 2, 2, 9, 39, 40, 102821)
>>> dt + datetime.timedelta(hours=3) # 3小时后
datetime.datetime(2017, 2, 5, 12, 39, 40, 102821)
>>> dt + datetime.timedelta(hours=-3) # 3小时前
datetime.datetime(2017, 2, 5, 6, 39, 40, 102821)
>>> dt + datetime.timedelta(hours=3, seconds=30) # 3小时30秒后
datetime.datetime(2017, 2, 5, 12, 40, 10, 102821)

五、时间格式码

time模块的struct_time以及datetime模块的datetime、date、time类都提供了strftime()方法,该方法可 以输出一个指定格式的时间字符串。具体格式由一系列的格式码(格式字符)组成,python最终调用的是各个平台c库的strftme()函数,因此各平台对全套格式码的支持会有所不同,具体情况需要参考该平台上的strftime(3)文档。下面列出了c标准(1989版)要求的所有格式码,它们在所有标准c实现的平台上都可以工作:

六、总结

那么python中处理时间时,使用time模块好,还是用datetime模块好呢?就我个人而言,datetime模块基本上可以满足需要,且用起来确实比较方便。对于time模块,我只是在取当前时间的时间戳时会用到time.time()方法,当然也可以通过datetime.datetime.now().timestamp()来获取,只是显得复杂一点。我觉得还是看个人习惯吧,没有什么绝对的好坏之分。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持php中文网。

更多python之日期与时间处理模块(date和datetime)相关文章请关注php中文网!

Posted in 未分类

发表评论