Python 标准库之 datetime

1. datetime 简介

datetime 是基于 time 模块进行了封装，提供了更高级的功能。该模块主要有以下几个类：

date： 表示日期的类。常用的属性有 year, month, day
time： 表示时间的类。常用的属性有 hour, minute, second, microsecond
datetime： 表示日期时间
timedelta： 表示时间间隔，即两个时间点之间的长度
tzinfo： 与时区有关的相关信息

2. date 类

2.1 date 类方法和类属性

date 类定义了一些常用的类方法与类属性:

max、min： date对象所能表示的最大、最小日期
resolution： date对象表示日期的最小单位。这里是天
today()： 返回一个表示当前本地日期的date对象
fromtimestamp(timestamp)： 根据给定的时间戮，返回一个date对象

In [1]: from datetime import date

In [2]: date.max
Out[2]: datetime.date(9999, 12, 31)

In [3]: date.min
Out[3]: datetime.date(1, 1, 1)

In [4]: date.today
Out[4]: <function today>

In [5]: date.today()
Out[5]: datetime.date(2018, 11, 23)

In [6]: date.resolution
Out[6]: datetime.timedelta(1)

In [7]: import time

In [8]: date.fromtimestamp(time.time())
Out[8]: datetime.date(2018, 11, 23)

2.2 date 类的实例方法和属性

date 提供的实例方法和属性：

.year： 返回年
.month： 返回月
.day： 返回日
.replace(year, month, day)： 生成一个新的日期对象，用参数指定的年，月，日代替原有对象中的属性。（原有对象仍保持不变）
.weekday()： 返回weekday，如果是星期一，返回0；如果是星期2，返回1，以此类推
.isoweekday()： 返回weekday，如果是星期一，返回1；如果是星期2，返回2，以此类推
.isocalendar()： 返回格式如(year, wk num, wk day)
.isoformat()： 返回格式如’YYYY-MM-DD’的字符串
.strftime(fmt)： 自定义格式化字符串。与time模块中的strftime类似

In [12]: today = date.today()

In [13]: today
Out[13]: datetime.date(2018, 11, 23)

In [14]: today.year
Out[14]: 2018

In [15]: today.month
Out[15]: 11

In [16]: today.day
Out[16]: 23

In [17]: today.weekday()
Out[17]: 4

In [18]: today.isoweekday()
Out[18]: 5

In [19]: today.isocalendar()
Out[19]: (2018, 47, 5)

In [21]: today.strftime("%Y-%m-%d %H:%M:%S")
Out[21]: '2018-11-23 00:00:00'

In [22]: today.isoformat()
Out[22]: '2018-11-23'

date 还对某些操作进行了重载，它允许我们对日期进行如下一些操作：

• date2 = date1 + timedelta # 日期加上一个间隔，返回一个新的日期对象
• date2 = date1 – timedelta # 日期减去一个间隔，返回一个新的日期对象
• timedelta = date1 – date2 # 两个日期相减，返回一个时间间隔对象
• date1 < date2 # 两个日期进行比较

In [23]: from datetime import timedelta

In [24]: yestoday = today - timedelta(1)

In [25]: yestoday
Out[25]: datetime.date(2018, 11, 22)

In [26]: yestoday < today
Out[26]: True

In [27]: the_day_last_month = today - timedelta(30)

In [28]: the_day_last_month
Out[28]: datetime.date(2018, 10, 24)

In [29]: the_day_last_month < today
Out[29]: True

3. time 类

3.1 time 类定义的类属性：

min、max： time 类所能表示的最小、最大时间。其中，time.min = time(0, 0, 0, 0)， time.max = time(23, 59, 59, 999999)
resolution： 时间的最小单位，这里是1微秒

In [30]: from datetime import time

In [31]: time.min
Out[31]: datetime.time(0, 0)

In [32]: time.max
Out[32]: datetime.time(23, 59, 59, 999999)

In [33]: time.resolution
Out[33]: datetime.timedelta(0, 0, 1)

3.2 time 类的实例方法和属性：

.hour、.minute、.second、.microsecond： 时、分、秒、微秒
.tzinfo： 时区信息
.replace([hour[, minute[, second[, microsecond[, tzinfo]]]]])： 创建一个新的时间对象，用参数指定的时、分、秒、微秒代替原有对象中的属性（原有对象仍保持不变）
.isoformat()： 返回型如”HH:MM:SS”格式的字符串表示
.strftime(fmt)： 返回自定义格式化字符串

像 date 一样，也可以对两个 time 对象进行比较，或者相减返回一个时间间隔对象。

4. datetime 类

datetime 是 date 与 time的 结合体，包括 date 与 time 的所有信息。它的构造函数如下：datetime.datetime(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])，各参数的含义与 date、time 的构造函数中的一样，要注意参数值的范围。

4.1 类属性和方法

datetime 类定义的类属性与方法：

• min、max： datetime 所能表示的最小值与最大值
• resolution： datetime最小单位
• today()： 返回一个表示当前本地时间的datetime对象
• now([tz])： 返回一个表示当前本地时间的datetime对象，如果提供了参数tz，则获取tz参数所指时区的本地时间
• utcnow()： 返回一个当前utc时间的datetime对象
• fromtimestamp(timestamp[, tz])： 根据时间戮创建一个datetime对象，参数tz指定时区信息
• utcfromtimestamp(timestamp)： 根据时间戮创建一个datetime对象
• combine(date, time)： 根据date和time，创建一个datetime对象
• strptime(date_string, format)： 将格式字符串转换为datetime对象

In [42]: from datetime import datetime

In [43]: datetime.min
Out[43]: datetime.datetime(1, 1, 1, 0, 0)

In [44]: datetime.max
Out[44]: datetime.datetime(9999, 12, 31, 23, 59, 59, 999999)

In [45]: datetime.resolution
Out[45]: datetime.timedelta(0, 0, 1)

In [46]: datetime.today()
Out[46]: datetime.datetime(2018, 11, 23, 18, 51, 33, 382000)

In [47]: datetime.now()
Out[47]: datetime.datetime(2018, 11, 23, 18, 51, 53, 771000)

In [48]: datetime.utcnow()
Out[48]: datetime.datetime(2018, 11, 23, 10, 52, 12, 749000)

In [49]: import time

In [50]: datetime.fromtimestamp(time.time())
Out[50]: datetime.datetime(2018, 11, 23, 18, 53, 37, 212000)

In [51]: datetime.utcfromtimestamp(time.time())
Out[51]: datetime.datetime(2018, 11, 23, 10, 54, 9, 287000)

In [54]: from datetime import date

In [55]: from datetime import time

In [56]: d = date(year=1900, month=10, day=15)

In [57]: d
Out[57]: datetime.date(1900, 10, 15)

In [58]: t = time(hour=20, minute=30, second=00)

In [59]: t
Out[59]: datetime.time(20, 30)

In [60]: datetime.combine(d,t)
Out[60]: datetime.datetime(1900, 10, 15, 20, 30)

4.2 实例属性和方法

datetime 类提供的实例方法与属性（很多属性或方法在date和time中已经出现过，在此有类似的意义，这里只罗列这些方法名，具体含义不再逐个展开介绍，可以参考上文对date与time类的讲解。）

• year、month、day、hour、minute、second、microsecond、tzinfo
• date()：获取date对象
• time()：获取time对象
• replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]])
• timetuple()
• utctimetuple()
• toordinal()
• weekday()
• isocalendar()
• isoformat([sep])
• ctime()：返回一个日期时间的C格式字符串，等效于time.ctime(time.mktime(dt.timetuple()))
• strftime(format)

像 date 一样，也可以对两个 datetime 对象进行比较，或者相减返回一个时间间隔对象，或者日期时间加上一个间隔返回一个新的日期时间对象。
最常用的是将时间字符格式化

import datetime
datetime.datetime.strptime("2019-03-24 03-11-17", "%Y-%m-%d %H-%M-%S")

返回结果：

datetime.datetime(2019, 3, 24, 3, 11, 17)

4.3 timedelta 类

通过 timedelta 函数返回一个 timedelta 对象，也就是一个表示时间间隔的对象。函数参数情况如下所示:

class datetime.timedelta([days[, seconds[, microseconds[, milliseconds[, minutes[,hours[, weeks]]]]]]])

其没有必填参数，简单控制的话第一个整数就是多少天的间隔的意思。

datetime.timedelta(10)

两个时间间隔对象可以彼此之间相加或相减，返回的仍是一个时间间隔对象。而更方便的是一个datetime 对象如果减去一个时间间隔对象，那么返回的对应减去之后的 datetime 对象，然后两个datetime 对象如果相减返回的是一个时间间隔对象。这很是方便。

参考链接：http://www.biaodianfu.com/python-datetime.html