Python时间模块: time

本文结构

• 三种时间表示
• time模块常用函数
• 时间格式化参数
• 三种时间格式转化

在平常的代码中，我们常常需要与时间打交道。在Python中，与时间处理有关的模块就包括：time，datetime以及calendar。这篇文章，主要讲解time模块。

---

三种时间表示

在Python中，通常有这几种方式来表示时间：

• 时间戳(timestamp)
  通常来说，时间戳表示的是从1970年1月1日00:00:00开始按秒计算的偏移量。我们运行“type(time.time())”，返回的是float类型。
• 格式化的时间字符串
• 元组(struct_time)
  struct_time元组共有9个元素共九个元素:(年，月，日，时，分，秒，一年中第几周，一年中第几天，夏令时)

由于Python的time模块实现主要调用C库，所以各个平台可能有所不同。

time模块常用函数

1. time()
   返回当前时间的时间戳

   time.time()  # 1455612740.474
   

2. localtime([secs])
   将一个时间戳转换为当前时区的struct_time。secs参数未提供，则以当前时间为准。

   time.localtime()  # time.struct_time(tm_year=2016, tm_mon=2, tm_mday=16, tm_hour=16, tm_min=52, tm_sec=20, tm_wday=1, tm_yday=47, tm_isdst=0)
   
   time.localtime(1304575584.1361799)  # time.struct_time(tm_year=2011, tm_mon=5, tm_mday=5, tm_hour=14, tm_min=6, tm_sec=24, tm_wday=3, tm_yday=125, tm_isdst=0)
   

3. gmtime([secs])
   和localtime()方法类似，gmtime()方法是将一个时间戳转换为UTC时区（0时区）的struct_time。

4. mktime(t)
   将一个struct_time转化为时间戳。

   time.mktime(time.localtime())  # 1455613671.0
   

5. asctime([t])
   把一个表示时间的元组或者struct_time表示为这种形式：'Sun Jun 20 23:21:05 1993'。如果没有参数，将会将time.localtime()作为参数传入。

   time.asctime()  # Tue Feb 16 17:12:23 2016
   

6. ctime([secs])
   把一个时间戳（按秒计算的浮点数）转化为time.asctime()的形式。如果参数未给或者为None的时候，将会默认time.time()为参数。它的作用相当于time.asctime(time.localtime(secs))。

   time.ctime()  # Tue Feb 16 17:14:04 2016
   
   time.ctime(time.time())  # Tue Feb 16 17:14:20 2016
   

7. sleep(secs)
   线程推迟指定的时间运行，单位为秒。

8. clock()
   这个需要注意，在不同的系统上含义不同。在UNIX系统上，它返回的是“进程时间”，它是用秒表示的浮点数（时间戳）。而在WINDOWS中，第一次调用，返回的是进程运行的实际时间。而第二次之后的调用是自第一次调用以后到现在的运行时间，即两次时间差。

9. strftime(format[, t])
   把一个代表时间的元组或者struct_time（如由time.localtime()和time.gmtime()返回）转化为格式化的时间字符串。如果t未指定，将传入time.localtime()。如果元组中任何一个元素越界，ValueError的错误将会被抛出。

   time.strftime("%Y-%m-%d %X", time.localtime())  # 2016-02-16 17:25:41
   

10. time.strptime(string[, format])
    把一个格式化时间字符串转化为struct_time。实际上它和strftime()是逆操作。

    time.strptime('2011-05-05 16:37:06', '%Y-%m-%d %X')  # time.struct_time(tm_year=2011, tm_mon=5, tm_mday=5, tm_hour=16, tm_min=37, tm_sec=6, tm_wday=3, tm_yday=125, tm_isdst=-1)
    

    在这个函数中，format默认为："%a %b %d %H:%M:%S %Y"。

---

时间格式化参数

格式	含义	备注
%a	本地（locale）简化星期名称
%A	本地完整星期名称
%b	本地简化月份名称
%B	本地完整月份名称
%c	本地相应的日期和时间表示
%d	一个月中的第几天（01 - 31）
%H	一天中的第几个小时（24小时制，00 - 23）
%I	第几个小时（12小时制，01 - 12）
%j	一年中的第几天（001 - 366）
%m	月份（01 - 12）
%M	分钟数（00 - 59）
%p	本地am或者pm的相应符	1
%S	秒（01 - 61）	2
%U	一年中的星期数。（00 - 53星期天是一个星期的开始。）第一个星期天之前的所有天数都放在第0周。	3
%w	一个星期中的第几天（0 - 6，0是星期天）
%W	和%U基本相同，不同的是%W以星期一为一个星期的开始。	3
%x	本地相应日期
%X	本地相应时间
%y	去掉世纪的年份（00 - 99）
%Y	完整的年份
%Z	时区的名字（如果不存在为空字符）
%%	‘%’字符

1: “%p”只有与“%I”配合使用才有效果。
2: 文档中强调确实是0 - 61，而不是59，闰年秒占两秒。
3: 当使用strptime()函数时，只有当在这年中的周数和天数被确定的时候%U和%W才会被计算。

---

三种时间格式转化