背景:

python 里面处理时间的类库主要是 time 和 datatime 两个库, 这两个库经常用混,今天彻底总结一下。

解决:

time 模块

Python 文档里,time是归类在Generic Operating System Services中,换句话说, 它提供的功能是更加接近于操作系统层面的。通读文档可知,time 模块​是围绕着 Unix Timestamp 进行的。

该模块主要包括一个类 struct_time,另外其他几个函数及相关常量。 需要注意的是在该模块中的大多数函数是调用了所在平台C library的同名函数, 所以要特别注意有些函数是平台相关的,可能会在不同的平台有不同的效果。另外一点是,由于是基于Unix Timestamp,所以其所能表述的日期范围被限定在 1970 - 2038 之间,如果你写的代码需要处理在前面所述范围之外的日期,那可能需要考虑使用datetime模块更好。文档解释比较费劲,具体看看怎么用:

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
In [1]: import time

In [2]: time.time()
Out[2]: 1414332433.345712
In [3]: timestamp = time.time()

In [4]: time.gmtime(timestamp)
Out[4]: time.struct_time(tm_year=2014, tm_mon=10, tm_mday=26, tm_hour=14, tm_min=7, tm_sec=13, tm_wday=6, tm_yday=299, tm_isdst=0)

In [5]: time.localtime(timestamp)
Out[5]: time.struct_time(tm_year=2014, tm_mon=10, tm_mday=26, tm_hour=22, tm_min=7, tm_sec=13, tm_wday=6, tm_yday=299, tm_isdst=0)
In [6]: struct_time = time.localtime(timestamp)

In [7]: time.ctime(timestamp)
Out[7]: 'Sun Oct 26 22:07:13 2014'

In [8]: time.asctime(struct_time)
Out[8]: 'Sun Oct 26 22:07:13 2014'

In [9]: time.mktime(struct_time)
Out[9]: 1414332433.0

In [10]: time.strftime("%a, %d %b %Y %H:%M:%S +0000", struct_time)
Out[10]: 'Sun, 26 Oct 2014 22:07:13 +0000'

In [11]: time.strptime("30 Nov 00", "%d %b %y")
Out[11]: time.struct_time(tm_year=2000, tm_mon=11, tm_mday=30, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=3, tm_yday=335, tm_isdst=-1)

time 模块的使用比较简单,对应时间的使用无非几种,时间戳(数值)、时间、字符串三者之间的相互转换。而上面time 模块的功能基本都能使用 datetime 模块来完成,下面我们来看一下 datetime 模块的具体使用。

datetime 模块

datetime 可以看做是对 time 模块的进一步封装,提供了很多实用的函数,datetime 包含的类如下:

1
2
3
4
5
6
datetime(obj)
  timedelta     # 主要用于计算时间跨度
  tzinfo        # 时区相关
  time          # 只关注时间
  date          # 只关注日期
  datetime      # 同时有时间和日期

其中用的比较多的是 datetime.datetimedatetime.timedelta 两个模块。下面对这两个模块重点讲解。
datetime.datetime 模块
可以通过 datetime.datetime.now() 来获取当前的时间信息。返回的是一个 datetime.datetime 对象,对于这个对象而言,主要包含了下面这些方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
datetime.year
datetime.month
datetime.day
datetime.hour
datetime.minute
datetime.second
datetime.microsecond
datetime.tzinfo

datetime.date() # 返回 date 对象
datetime.time() # 返回 time 对象
datetime.replace(name=value) # 前面所述各项属性是 read-only 的,需要此方法才可更改
datetime.timetuple() # 返回time.struct_time 对象
dattime.strftime(format) # 按照 format 进行格式化输出
除了对象身上有上面这些方法外,datetime 还有一些类方法,供我们使用:
datetime.today()a  # 当前时间,localtime
datetime.now([tz]) # 当前时间默认 localtime
datetime.utcnow()  # UTC 时间
datetime.fromtimestamp(timestamp[, tz]) # 由 Unix Timestamp 构建对象
datetime.strptime(date_string, format)  # 给定时间格式解析字符串

上面的方法都非常常用,在日常的字符串,时间戳相互转换中经常用到。上面省略了时区的相关函数,需要的时候自行查询。
datetime.timedelta 模块

1
2
3
4
5
6
7
8
9
10
11
In [1]: import datetime
In [2]: time_now = datetime.datetime.now()
In [3]: time_now
Out[3]: datetime.datetime(2014, 10, 27, 21, 46, 16, 657523)

In [4]: delta1 = datetime.timedelta(hours=25)
In [5]: print(time_now + delta1)
2014-10-28 22:46:16.657523

In [6]: print(time_now - delta1)
2014-10-26 20:46:16.657523

两个datetime.datetime 对象可以直接相减,得到的就是一个 timedelta 对象。

时间戳与时间对象的转换

通过前面的讲解,我们已经知道了字符串和时间之间的转换方法。但是日常还有一种时间格式,时间戳,也经常需要和时间进行转换,这个怎么处理呢? 
获取当前时间戳

1
2
import time
time.time()

datetime.datetime 对象转时间戳

  1. python3中,提供了 datetime.datetime.timestamp 可以直接将datetime.datetime 对象转换为 timestamp 对象
  2. python2中,需要曲线救国
    1
    2
    - datetime.datetime.now().timestamp() 将 datetime 对象转为一个 time 对象
    - time.mktime(timetuple_obj) 使用 time.mktime 来创建一个 time 对象

时间戳对象转 datetime
时间戳转 datetime 也很简单,
datetime.datetime.fromtimestamp(time.time())

后话

strftime / strptime 怎么记忆?
p 可以简单看作是parse ,就是从字符串里面 parse 出来具体的日期对象是什么? 
f 可以简单看作是format,  就是把日期对象 format 成一个字符串。