每週一個 Python 模塊 | time

專欄地址：每週一個 Python 模塊

幾乎全部的正式代碼中，咱們都須要與時間打交道。在Python中，與時間處理有關的模塊包括time，datetime以及calendar，本節主要講解time模塊。

在 Python 中，用三種方式來表示時間，分別是時間戳、格式化時間字符串和結構化時間

1. 時間戳（timestamp）：也就是 1970 年 1 月 1 日以後的秒，例如 1506388236.216345，能夠經過time.time()得到。時間戳是一個浮點數，能夠進行加減運算，但請注意不要讓結果超出取值範圍。
2. 格式化的時間字符串（string_time）：也就是年月日時分秒這樣的咱們常見的時間字符串，例如2017-09-26 09:12:48，能夠經過time.strftime('%Y-%m-%d')得到;
3. 結構化時間（struct_time）：一個包含了年月日時分秒的多元元組，例如time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=9, tm_min=14, tm_sec=50, tm_wday=1, tm_yday=269, tm_isdst=0)，能夠經過time.localtime()得到。

因爲 Python 的 time 模塊實現主要調用 C 庫，因此各個平臺可能有所不一樣。time 模塊目前只支持到 2038 年前。若是須要處理範圍以外的日期，請使用 datetime 模塊。

UTC（Coordinated Universal Time，世界協調時），亦即格林威治天文時間，世界標準時間。咱們中國爲東八區，比 UTC 早 8 個小時，也就是 UTC+8。關於 UTC 的縮寫，有個故事，你可能已經注意到了，按英文的縮寫，應該是 CUT，而不是 UTC。可是世界協調時在法文中的縮寫是 TUC，兩國互相不讓，做爲妥協，最後乾脆簡稱 UTC。

DST（Daylight Saving Time）即夏令時。

結構化時間（struct_time）

使用time.localtime()等方法能夠得到一個結構化時間元組。

>>> time.localtime()
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=10, tm_min=6, tm_sec=49, tm_wday=1, tm_yday=269, tm_isdst=0)
複製代碼

結構化時間元組共有 9 個元素，按順序排列以下表：

索引	屬性	取值範圍
0	tm_year（年）	好比2017
1	tm_mon（月）	1 - 12
2	tm_mday（日）	1 - 31
3	tm_hour（時）	0 - 23
4	tm_min（分）	0 - 59
5	tm_sec（秒）	0 - 61
6	tm_wday（weekday）	0 - 6（0表示週一）
7	tm_yday（一年中的第幾天）	1 - 366
8	tm_isdst（是不是夏令時）	默認爲-1

既然結構化時間是一個元組，那麼就能夠經過索引進行取值，也能夠進行分片，或者經過屬性名獲取對應的值。

>>>import time
>>> lt = time.localtime()
>>> lt
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=9, tm_min=27, tm_sec=29, tm_wday=1, tm_yday=269, tm_isdst=0)
>>> lt[3]
9
>>> lt[2:5]
(26, 9, 27)
>>> lt.tm_wday
1
複製代碼

可是要記住，Python 的 time 類型是不可變類型，全部的時間值都只讀，不能改！！

>>> lt.tm_wday = 2
Traceback (most recent call last):
  File "<pyshell#12>", line 1, in <module>
    lt.tm_wday = 2
AttributeError: readonly attribute
複製代碼

格式化時間字符串

利用time.strftime('%Y-%m-%d %H:%M:%S')等方法能夠得到一個格式化時間字符串。

>>> time.strftime('%Y-%m-%d %H:%M:%S')
'2017-09-26 10:04:28'
複製代碼

注意其中的空格、短橫線和冒號都是美觀修飾符號，真正起控制做用的是百分符。對於格式化控制字符串"%Y-%m-%d %H:%M:%S，其中每個字母所表明的意思以下表所示，注意大小寫的區別：

格式	含義
%a	本地星期名稱的簡寫（如星期四爲Thu）
%A	本地星期名稱的全稱（如星期四爲Thursday）
%b	本地月份名稱的簡寫（如八月份爲agu）
%B	本地月份名稱的全稱（如八月份爲august）
%c	本地相應的日期和時間的字符串表示（如：15/08/27 10:20:06）
%d	一個月中的第幾天（01 - 31）
%f	微秒（範圍0.999999）
%H	一天中的第幾個小時（24小時制，00 - 23）
%I	第幾個小時（12小時制，0 - 11）
%j	一年中的第幾天（001 - 366）
%m	月份（01 - 12）
%M	分鐘數（00 - 59）
%p	本地am或者pm的標識符
%S	秒（00 - 61）
%U	一年中的星期數。（00 - 53星期天是一個星期的開始。）第一個星期天之 前的全部天數都放在第0周。
%w	一個星期中的第幾天（0 - 6，0是星期天）
%W	和%U基本相同，不一樣的是%W以星期一爲一個星期的開始。
%x	本地相應日期字符串（如15/08/01）
%X	本地相應時間字符串（如08:08:10）
%y	去掉世紀的年份（00 - 99）兩個數字表示的年份
%Y	完整的年份（4個數字表示年份）
%z	與UTC時間的間隔（若是是本地時間，返回空字符串）
%Z	時區的名字（若是是本地時間，返回空字符串）
%%	‘%’字符

time 模塊主要方法

time.sleep(t)

time 模塊最經常使用的方法之一，用來睡眠或者暫停程序 t 秒，t 能夠是浮點數或整數。

time.time()

返回當前系統時間戳。時間戳能夠作算術運算。

>>> time.time()
1506391907.020303
複製代碼

該方法常常用於計算程序運行時間：

import time

def func():
    time.sleep(1.14)
    pass

t1 = time.time()
func()
t2 = time.time()
print(t2 - t1)
複製代碼

time.gmtime([secs])

將一個時間戳轉換爲 UTC 時區的結構化時間。可選參數 secs 的默認值爲time.time()。

>>> time.gmtime()
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=2, tm_min=14, tm_sec=17, tm_wday=1, tm_yday=269, tm_isdst=0)

>>> t = time.time() - 10000
>>> time.gmtime(t)
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=25, tm_hour=23, tm_min=31, tm_sec=3, tm_wday=0, tm_yday=268, tm_isdst=0)
複製代碼

time.localtime([secs])

將一個時間戳轉換爲當前時區的結構化時間。若是 secs 參數未提供，則以當前時間爲準，即time.time()。

>>> time.localtime()
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=10, tm_min=20, tm_sec=42, tm_wday=1, tm_yday=269, tm_isdst=0)

>>> time.localtime(1406391907)
time.struct_time(tm_year=2014, tm_mon=7, tm_mday=27, tm_hour=0, tm_min=25, tm_sec=7, tm_wday=6, tm_yday=208, tm_isdst=0)

>>> time.localtime(time.time() + 10000)
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=13, tm_min=7, tm_sec=54, tm_wday=1, tm_yday=269, tm_isdst=0)
複製代碼

time.ctime([secs])

把一個時間戳轉化爲本地時間的格式化字符串。默認使用time.time()做爲參數。

>>> time.ctime()
'Tue Sep 26 10:22:31 2017'
>>> time.ctime(time.time())
'Tue Sep 26 10:23:51 2017'
>>> time.ctime(1406391907)
'Sun Jul 27 00:25:07 2014'
>>> time.ctime(time.time() + 10000)
'Tue Sep 26 13:11:55 2017'
複製代碼

time.asctime([t])

把一個結構化時間轉換爲Sun Aug 23 14:31:59 2017這種形式的格式化時間字符串。默認將time.localtime()做爲參數。

>>> time.asctime()
'Tue Sep 26 10:27:23 2017'

>>> time.asctime(time.time())
Traceback (most recent call last):
  File "<pyshell#13>", line 1, in <module>
    time.asctime(time.time())
TypeError: Tuple or struct_time argument required
    
>>> time.asctime(time.localtime())
'Tue Sep 26 10:27:45 2017'
>>> time.asctime(time.gmtime())
'Tue Sep 26 02:27:57 2017'
複製代碼

time.mktime(t)

將一個結構化時間轉化爲時間戳。time.mktime()執行與gmtime(),localtime()相反的操做，它接收struct_time對象做爲參數,返回用秒數表示時間的浮點數。若是輸入的值不是一個合法的時間，將觸發OverflowError或ValueError。

>>> time.mktime(1406391907)
Traceback (most recent call last):
  File "<pyshell#16>", line 1, in <module>
    time.mktime(1406391907)
TypeError: Tuple or struct_time argument required
    
>>> time.mktime(time.localtime())
1506393039.0
複製代碼

time.strftime(format [, t])

返回格式化字符串表示的當地時間。把一個struct_time（如time.localtime()和time.gmtime()的返回值）轉化爲格式化的時間字符串，顯示的格式由參數format決定。若是未指定 t，默認傳入time.localtime()。若是元組中任何一個元素越界，就會拋出ValueError的異常。

>>> time.strftime("%Y-%m-%d %H:%M:%S")
'2017-09-26 10:34:50'
>>> time.strftime("%Y-%m-%d %H:%M:%S",time.gmtime())
'2017-09-26 02:34:53'
複製代碼

time.strptime(string[,format])

將格式化時間字符串轉化成結構化時間。該方法是time.strftime()方法的逆操做。time.strptime()方法根據指定的格式把一個時間字符串解析爲時間元組。要注意的是，你提供的字符串要和 format 參數的格式一一對應，若是 string 中日期間使用「-」分隔，format 中也必須使用「-」分隔，時間中使用冒號「:」分隔，後面也必須使用冒號分隔，不然會報格式不匹配的錯誤。而且值也要在合法的區間範圍內，千萬不要整出 14 個月來。

>>> import time
>>> stime = "2017-09-26 12:11:30"
>>> st = time.strptime(stime,"%Y-%m-%d %H:%M:%S")
>>> st
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=12, tm_min=11, tm_sec=30, tm_wday=1, tm_yday=269, tm_isdst=-1)
>>> for item in st:
    print(item)


2017
9
26
12
11
30
1
269
-1
>>> wrong_time = "2017-14-26 12:11:30"
>>> st  = time.strptime(wrong_time,"%Y-%m-%d %H:%M:%S")
Traceback (most recent call last):
  File "<pyshell#8>", line 1, in <module>
    st  = time.strptime(wrong_time,"%Y-%m-%d %H:%M:%S")
  File "C:\Python36\lib\_strptime.py", line 559, in _strptime_time
    tt = _strptime(data_string, format)[0]
  File "C:\Python36\lib\_strptime.py", line 362, in _strptime
    (data_string, format))
ValueError: time data '2017-14-26 12:11:30' does not match format '%Y-%m-%d %H:%M:%S'
複製代碼

time.clock()

返回執行當前程序的 CPU 時間。用來衡量不一樣程序的耗時。該方法在不一樣的系統上含義不一樣。在 Unix 系統上，它返回的是「進程時間」，用秒錶示的浮點數（時間戳）。在 Windows 中，第一次調用，返回的是進程運行的實際時間，而第二次以後的調用是自第一次調用之後到如今的運行時間。

import time

def procedure() :
  time.sleep(3)

time1 = time.clock()
procedure()
print(time.clock() - time1, "seconds process time!") 

# 2.999257758349577 seconds process time!
複製代碼

時間格式之間的轉換

Python 的三種類型時間格式，能夠互相進行轉換，以下圖和下表所示：

從	到	方法
時間戳	UTC結構化時間	gmtime()
時間戳	本地結構化時間	localtime()
UTC結構化時間	時間戳	calendar.timegm()
本地結構化時間	時間戳	mktime()
結構化時間	格式化字符串	strftime()
格式化字符串	結構化時間	strptime()

>>> t = time.time()         # t是一個時間戳

>>> time.gmtime(t - 10000)      # t減去1萬秒，而後轉換成UTC結構化時間
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=25, tm_hour=22, tm_min=50, tm_sec=36, tm_wday=0, tm_yday=268, tm_isdst=0)

>>> lt = time.localtime(t - 10000)  # t減去1萬秒，而後轉換成中國本地結構化時間
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=6, tm_min=50, tm_sec=36, tm_wday=1, tm_yday=269, tm_isdst=0)

>>> time.mktime(lt)     # 從本地結構化時間轉換爲時間戳
1506379836.0
>>> st = time.strftime("%Y-%m-%d %H:%M:%S",lt)  # 從本地結構化時間轉換爲時間字符串
>>> st
'2017-09-26 06:50:36'

>>> lt2 = time.strptime(st, "%Y-%m-%d %H:%M:%S") # 從時間字符串轉換爲結構化時間
>>> lt2
time.struct_time(tm_year=2017, tm_mon=9, tm_mday=26, tm_hour=6, tm_min=50, tm_sec=36, tm_wday=1, tm_yday=269, tm_isdst=-1)
複製代碼

相關文檔：

pymotw.com/3/time/inde…

www.liujiangblog.com/course/pyth…