#!/usr/bin/python
#coding:utf8


# 在應用程式的開發過程中，難免要跟日期、時間處理打交道。
# 如：記錄一個複雜演算法的執行時間；網路通訊中資料包的延遲等等。
# Python中提供了time, datetime calendar等模組來處理時間日期，
# 今天對time模組中最常用的幾個函式作一個介紹。

# 匯入時間模組
import time 

# time.time()函式返回的是從1970年1月1日以來的秒數，這是一個浮點型小數
#——————————————————————————————————————————————————————————————————
yesterday  time.time() - 86400      #代表昨天數這個時候的時間
today = time.time()                 #代表今天的時間
tomorrow = time.time() + 86400      #帶表明天的時間

#out1>  1382686284.44
#out2>  1382772684.44
#out3>  1382859084.44
#——————————————————————————————————————————————————————————————————


#time.sleep()一般用再程序方面，主要做用掛起當前程序，表示睡眠的時間，
	# 是以秒做單位的
#——————————————————————————————————————————————————————————————————
time.sleep(2)
print '兩秒後執行列印'

#間隔兩秒執行 out>  兩秒後執行列印
#——————————————————————————————————————————————————————————————————


# time.clock()返回第一次呼叫該方法到現在的秒數，其精確度高於1微秒。可
# 	以使用該函式來記錄程式執行的時間。下面是一個簡單的例子：
#——————————————————————————————————————————————————————————————————
print time.clock()             #初始clock時間   
time.sleep(2)
print time.clock()             #距離初始值得時間2秒 
date_time =  time.clock()
time.sleep(3)
print time.clock()             #距離初始值得時間5秒
print time.clock() - date_time    #表示中間的時間

# out1 >   6.39362683277e-07
# out2 >   2.01080107349
# out3 >   5.02091962732
# out4 >   3.00097215096
#——————————————————————————————————————————————————————————————————


# time.gmtime()該函式的模型是time.gmtime([sec]),sec表示從1970-1-1以來的秒數,
# 	其中預設值為time.time(),函式返回值習time.struct_time型別的物件(
# 		struct_time是在time模組中定義的表示時間的物件),
#——————————————————————————————————————————————————————————————————
print time.gmtime()   			#獲取當時的時間，並返回時間的物件(struct_time)
print time.gmtime(time.time() - 24*60*60)    #表示昨天當時的時間

#out1 > time.struct_time(tm_year=2013, tm_mon=10, tm_mday=26, tm_hour=8, tm_min=0, tm_sec=9, tm_wday=5, tm_yday=299, tm_isdst=0)
#out2 > time.struct_time(tm_year=2013, tm_mon=10, tm_mday=25, tm_hour=8, tm_min=0, tm_sec=9, tm_wday=4, tm_yday=298, tm_isdst=0)
#——————————————————————————————————————————————————————————————————


# time.localtime()這個函式與time.gmtime()函式非常相似,也返回一個struct_time物件,
# 	可以吧time.localtime看做time.gmtime的一個本地化操作
#——————————————————————————————————————————————————————————————————
print time.localtime()

#out > time.struct_time(tm_year=2013, tm_mon=10, tm_mday=26, tm_hour=8, tm_min=0, tm_sec=9, tm_wday=5, tm_yday=299, tm_isdst=0)
#——————————————————————————————————————————————————————————————————


# time.mktime()執行是與time.gmtime()和time.localtime()相反的操作,他接受的struct_time物件
# 	返回用的浮點型表示的秒數
#——————————————————————————————————————————————————————————————————
print time.mktime(time.localtime())
print time.mktime(time.gmtime())
print time.time()

# out1 > 1382774990.0
# out2 > 1382746190.0
# out3 > 1382774990.14
#——————————————————————————————————————————————————————————————————


# time.strftime()將日期轉換為字串表示，它的函式原型為：time.strftime(format[, t])。
# 	引數format是格式字串（格式字串的知識可以參考：time.strftime），
# 	可選的引數t是一個struct_time物件。下面的例子將struct_time物件轉換為字串表示：
#——————————————————————————————————————————————————————————————————
print time.strftime('%Y-%m-%d %H:%M:%S',time.localtime())    #輸出當地是時間的日期
print time.strftime('%Y')                    #獲取年份
print time.strftime('%H')                   #獲取小時的時間

#out 1> 2013-10-26 16:15:16
#out 2> 2013
#out 3> 16
#——————————————————————————————————————————————————————————————————

# time.strptime()按指定格式解析一個表示時間的字串，返回struct_time物件。
# 	該函式原型為：time.strptime(string, format)，兩個引數都是字串，
# 	下面是一個簡單的例子，演示將一個字串解析為一個struct_time物件：

#——————————————————————————————————————————————————————————————————
print time.strptime('2009-06-23 15:30:53', '%Y-%m-%d %H:%M:%S')  #返回struct_time物件
print time.strptime('2009', '%Y')   #如果只是給年份的，器他的引數將會表示為出的值

#out 1> time.struct_time(tm_year=2009, tm_mon=6, tm_mday=23, tm_hour=15, tm_min=30, tm_sec=53, tm_wday=1, tm_yday=174, tm_isdst=-1)
#out 2> time.struct_time(tm_year=2009, tm_mon=1, tm_mday=1, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=3, tm_yday=1, tm_isdst=-1)
#——————————————————————————————————————————————————————————————————


# time.ctime()也是是以個浮點型的秒數轉化為時間字串
#——————————————————————————————————————————————————————————————————
d_time  = time.time()
print time.ctime(d_time)    #輸出的格式與 '2013-10-26 16:29:30' 這個不一樣

# out >  Sat Oct 26 17:06:11 2013     
#——————————————————————————————————————————————————————————————————


# time.asctime()獲取當前的時間以簡化方式顯示(可選引數struct_time物件)
#——————————————————————————————————————————————————————————————————
print time.asctime(time.localtime())           #引數可選
print time.asctime()


# out 1>  Sat Oct 26 17:24:46 2013
# out 2>  Sat Oct 26 17:24:46 2013
#——————————————————————————————————————————————————————————————————



#++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
  # %y 兩位數的年份表示（00-99）
  # %Y 四位數的年份表示（000-9999）
  # %m 月份（01-12）
  # %d 月內中的一天（0-31）
  # %H 24小時制小時數（0-23）
  # %I 12小時制小時數（01-12） 
  # %M 分鐘數（00=59）
  # %S 秒（00-59）  
  # %a 本地簡化星期名稱
  # %A 本地完整星期名稱
  # %b 本地簡化的月份名稱
  # %B 本地完整的月份名稱
  # %c 本地相應的日期表示和時間表示
  # %j 年內的一天（001-366）
  # %p 本地A.M.或P.M.的等價符
  # %U 一年中的星期數（00-53）星期天為星期的開始
  # %w 星期（0-6），星期天為星期的開始
  # %W 一年中的星期數（00-53）星期一為星期的開始
  # %x 本地相應的日期表示
  # %X 本地相應的時間表示
  # %Z 當前時區的名稱
  # %% %號本身 
# 下面是一個練習，
#++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++






# 練習1(日期的轉化成秒)
#——————————————————————————————————————————————————————————————————
d_time = '2013-10-26 16:29:30'
# 首先將時間格式的轉分分struct_time物件( 運用time.strptime()方法 )
d_obj = time.strptime(d_time,'%Y-%m-%d %H:%M:%S')        #注意格式要對應

#在的用time.mktime()模組將struct_time的物件轉化為秒數
s_time = time.mktime(d_obj)
print s_time

# out 1> 1382776170.0
#——————————————————————————————————————————————————————————————————




time.gmtime() 與 time.localtime()的不同：

>>> time.strftime('%Y%m%d %H:%M:%S',time.gmtime(time.time()))
'20131202 03:00:24'
>>> time.strftime('%Y%m%d %H:%M:%S',time.localtime(time.time()))
'20131202 11:00:27' 

兩個獲取字串的時間相差(4個小時)