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 对象如果相减返回的是一个时间间隔对象。这很是方便。