Python time模塊參考手冊

Python的time模塊提供了各類操做時間的功能。在大多數的編程語言中，表示時間的方法有兩種，一是時間戳。即從1970年1月1日00:00:00開始按秒計算的偏移量；二是該語言本身的數據結構。Python中表示時間的數據結構元組，共有九個元素, 即：

(tm_year, tm_mon, tm_mday, tm_hour, tm_min, tm_sec, tm_wday, tm_yday, tm_isdst)

每一個元素分別表示以下含義：

year (four digits, e.g. 1998)
month (1-12)
day (1-31)
hours (0-23)
minutes (0-59)
seconds (0-59)
weekday (0-6, Monday is 0)
Julian day (day in the year, 1-366)
DST (Daylight Savings Time) flag (-1, 0 or 1) 是不是夏令時

UTC與DST時間標準簡介

UTC（Coordinated Universal Time，世界協調時）亦即格林威治天文時間，世界標準時間。在中國爲UTC+8。
DST（Daylight Saving Time）即夏令時。是一種爲節約能源而人爲規定地方時間的制度，通常在天亮早的夏季人爲將時間提早一小時。

模塊變量

timezone

當地時間與標準UTC時間的偏差，以秒計

altzone

當地夏令時時間與標準UTC時間的偏差，以秒計

daylight

當地時間是否反映夏令時，默認爲0

tzname

關於(標準時區名稱, 夏令時時區名稱)的元組

模塊方法

asctime([tuple])

將時間元組（默認爲本地時間）格式轉換爲字符串形式。接受一個時間元組，其默認值爲localtime()返回值

clock()

返回當前程序的cpu執行時間。unix系統始終返回所有運行時間；而windows從第二次開始都是以第一次調用此函數時的時間戳做爲基準，而不是程序開始時間爲基準。不接受參數。

ctime(seconds)

將時間戳轉換爲字符串。接受一個時間戳，其默認值爲當前時間戳。等價於asctime(localtime(seconds))

gmtime([seconds])

將時間戳轉換爲UTC時間元組格式。接受一個浮點型時間戳參數，其默認值爲當前時間戳。

localtime([seconds])

將時間戳轉換爲本地時間元組格式。接受一個浮點型時間戳參數，其默認值爲當前時間戳。

mktime(tuple)

將本地時間元組轉換爲時間戳。接受一個時間元組，必選。

sleep(seconds)

延遲一個時間段，接受整型、浮點型。

strftime(format[, tuple])

將時間元組以指定的格式轉換爲字符串形式。接受字符串格式化串、時間元組。時間元組爲可選，默認爲localtime()。示例：

>>> time.strftime("%Y-%m-%d %X", time.localtime())
'2011-05-05 16:37:06'

strptime(string, format)

將指定格式的時間字符串解析爲時間元組，strftime()的逆向過程。接受字符串，時間格式2個參數，都是必選。示例：

>>> time.strptime('2015-08-05 22:08:06', '%Y-%m-%d %X')
time.struct_time(tm_year=2015, tm_mon=8, tm_mday=5, tm_hour=22, tm_min=8, tm_sec=6, tm_wday=2, tm_yday=217, tm_isdst=-1)

time()

返回當前時間戳，浮點數形式。不接受參數

tzset()

改變本地時區。

時間字符串支持的格式

%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的相應符
    %S  秒（01 - 61）
    %U  一年中的星期數。（00 - 53星期天是一個星期的開始。）第一個星期天以前的全部天數都放在第0周。
    %w  一個星期中的第幾天（0 - 6，0是星期天）
    %W  和%U基本相同，不一樣的是%W以星期一爲一個星期的開始。    
    %x  本地相應日期   
    %X  本地相應時間   
    %y  去掉世紀的年份（00 - 99）   
    %Y  完整的年份  
    %Z  時區的名字（若是不存在爲空字符）     
    %%  ‘%’字符

注：
一、「%p」只有與「%I」配合使用纔有效果。
二、文檔中強調確實是0 - 61，而不是59，閏年秒佔兩秒（汗一個）。
三、當使用strptime()函數時，只有當在這年中的週數和天數被肯定的時候%U和%W纔會被計算。

各類時間表示的轉化