Python模塊學(xué)習(xí) datetime介紹

更新時(shí)間：2012年08月27日 15:03:48 作者：

Python提供了多個(gè)內(nèi)置模塊用于操作日期時(shí)間，像calendar，time，datetime。time模塊我在之前的文章已經(jīng)有所介紹，它提供的接口與C標(biāo)準(zhǔn)庫(kù)time.h基本一致

相比于time模塊，datetime模塊的接口則更直觀、更容易調(diào)用。今天就來講講datetime模塊。

datetime模塊定義了兩個(gè)常量：datetime.MINYEAR和datetime.MAXYEAR，分別表示datetime所能表示的最小、最大年份。其中，MINYEAR = 1，MAXYEAR = 9999。（對(duì)于偶等玩家，這個(gè)范圍已經(jīng)足夠用矣~~）

datetime模塊定義了下面這幾個(gè)類：

•datetime.date：表示日期的類。常用的屬性有year, month, day；
•datetime.time：表示時(shí)間的類。常用的屬性有hour, minute, second, microsecond；
•datetime.datetime：表示日期時(shí)間。
•datetime.timedelta：表示時(shí)間間隔，即兩個(gè)時(shí)間點(diǎn)之間的長(zhǎng)度。
•datetime.tzinfo：與時(shí)區(qū)有關(guān)的相關(guān)信息。（這里不詳細(xì)充分討論該類，感興趣的童鞋可以參考python手冊(cè)）
注：上面這些類型的對(duì)象都是不可變（immutable）的。

下面詳細(xì)介紹這些類的使用方式。

date類
date類表示一個(gè)日期。日期由年、月、日組成（地球人都知道~~）。date類的構(gòu)造函數(shù)如下：

class datetime.date(year, month, day)：參數(shù)的意義就不多作解釋了，只是有幾點(diǎn)要注意一下：

•year的范圍是[MINYEAR, MAXYEAR]，即[1, 9999]；
•month的范圍是[1, 12]。（月份是從1開始的，不是從0開始的~_~）；
•day的最大值根據(jù)給定的year, month參數(shù)來決定。例如閏年2月份有29天；
date類定義了一些常用的類方法與類屬性，方便我們操作：

•date.max、date.min：date對(duì)象所能表示的最大、最小日期；
•date.resolution：date對(duì)象表示日期的最小單位。這里是天。
•date.today()：返回一個(gè)表示當(dāng)前本地日期的date對(duì)象；
•date.fromtimestamp(timestamp)：根據(jù)給定的時(shí)間戮，返回一個(gè)date對(duì)象；
•datetime.fromordinal(ordinal)：將Gregorian日歷時(shí)間轉(zhuǎn)換為date對(duì)象；（Gregorian Calendar：一種日歷表示方法，類似于我國(guó)的農(nóng)歷，西方國(guó)家使用比較多，此處不詳細(xì)展開討論。）

使用例子：

復(fù)制代碼代碼如下:

 
from datetime import * 
import time 

print 'date.max:', date.max 
print 'date.min:', date.min 
print 'date.today():', date.today() 
print 'date.fromtimestamp():', date.fromtimestamp(time.time()) 

# # ---- 結(jié)果 ---- 
# date.max: 9999-12-31 
# date.min: 0001-01-01 
# date.today(): 2010-04-06 
# date.fromtimestamp(): 2010-04-06 

date提供的實(shí)例方法和屬性：

•date.year、date.month、date.day：年、月、日；
•date.replace(year, month, day)：生成一個(gè)新的日期對(duì)象，用參數(shù)指定的年，月，日代替原有對(duì)象中的屬性。（原有對(duì)象仍保持不變）
•date.timetuple()：返回日期對(duì)應(yīng)的time.struct_time對(duì)象；
•date.toordinal()：返回日期對(duì)應(yīng)的Gregorian Calendar日期；
•date.weekday()：返回weekday，如果是星期一，返回0；如果是星期2，返回1，以此類推；
•data.isoweekday()：返回weekday，如果是星期一，返回1；如果是星期2，返回2，以此類推；
•date.isocalendar()：返回格式如(year，month，day)的元組；
•date.isoformat()：返回格式如'YYYY-MM-DD'的字符串；
•date.strftime(fmt)：自定義格式化字符串。在下面詳細(xì)講解。

使用例子：

復(fù)制代碼代碼如下:

 
now = date(2010, 04, 06) 
tomorrow = now.replace(day = 07) 
print 'now:', now, ', tomorrow:', tomorrow 
print 'timetuple():', now.timetuple() 
print 'weekday():', now.weekday() 
print 'isoweekday():', now.isoweekday() 
print 'isocalendar():', now.isocalendar() 
print 'isoformat():', now.isoformat() 

# # ---- 結(jié)果 ---- 
# now: 2010-04-06 , tomorrow: 2010-04-07 
# timetuple(): (2010, 4, 6, 0, 0, 0, 1, 96, -1) 
# weekday(): 1 
# isoweekday(): 2 
# isocalendar(): (2010, 14, 2) 
# isoformat(): 2010-04-06 

date還對(duì)某些操作進(jìn)行了重載，它允許我們對(duì)日期進(jìn)行如下一些操作：

•date2 = date1 + timedelta # 日期加上一個(gè)間隔，返回一個(gè)新的日期對(duì)象（timedelta將在下面介紹，表示時(shí)間間隔）
•date2 = date1 - timedelta # 日期隔去間隔，返回一個(gè)新的日期對(duì)象
•timedelta = date1 - date2 # 兩個(gè)日期相減，返回一個(gè)時(shí)間間隔對(duì)象
•date1 < date2 # 兩個(gè)日期進(jìn)行比較
注：對(duì)日期進(jìn)行操作時(shí)，要防止日期超出它所能表示的范圍。

使用例子：

復(fù)制代碼代碼如下:

 
now = date.today() 
tomorrow = now.replace(day = 7) 
delta = tomorrow - now 
print 'now:', now, ' tomorrow:', tomorrow 
print 'timedelta:', delta 
print now + delta 
print tomorrow > now 

# # ---- 結(jié)果 ---- 
# now: 2010-04-06 tomorrow: 2010-04-07 
# timedelta: 1 day, 0:00:00 
# 2010-04-07 
# True 

Time類
time類表示時(shí)間，由時(shí)、分、秒以及微秒組成。（我不是從火星來的~~）time類的構(gòu)造函數(shù)如下：

class datetime.time(hour[, minute[, second[, microsecond[, tzinfo]]]]) ：各參數(shù)的意義不作解釋，這里留意一下參數(shù)tzinfo，它表示時(shí)區(qū)信息。注意一下各參數(shù)的取值范圍：hour的范圍為[0, 24)，minute的范圍為[0, 60)，second的范圍為[0, 60)，microsecond的范圍為[0, 1000000)。

time類定義的類屬性：

•time.min、time.max：time類所能表示的最小、最大時(shí)間。其中，time.min = time(0, 0, 0, 0)， time.max = time(23, 59, 59, 999999)；
•time.resolution：時(shí)間的最小單位，這里是1微秒；
time類提供的實(shí)例方法和屬性：

•time.hour、time.minute、time.second、time.microsecond：時(shí)、分、秒、微秒；
•time.tzinfo：時(shí)區(qū)信息；
•time.replace([hour[, minute[, second[, microsecond[, tzinfo]]]]])：創(chuàng)建一個(gè)新的時(shí)間對(duì)象，用參數(shù)指定的時(shí)、分、秒、微秒代替原有對(duì)象中的屬性（原有對(duì)象仍保持不變）；
•time.isoformat()：返回型如"HH:MM:SS"格式的字符串表示；
•time.strftime(fmt)：返回自定義格式化字符串。在下面詳細(xì)介紹；

使用例子：

復(fù)制代碼代碼如下:

 
from datetime import * 
tm = time(23, 46, 10) 
print 'tm:', tm 
print 'hour: %d, minute: %d, second: %d, microsecond: %d' / 
% (tm.hour, tm.minute, tm.second, tm.microsecond) 
tm1 = tm.replace(hour = 20) 
print 'tm1:', tm1 
print 'isoformat():', tm.isoformat() 

# # ---- 結(jié)果 ---- 
# tm: 23:46:10 
# hour: 23, minute: 46, second: 10, microsecond: 0 
# tm1: 20:46:10 
# isoformat(): 23:46:10 

像date一樣，也可以對(duì)兩個(gè)time對(duì)象進(jìn)行比較，或者相減返回一個(gè)時(shí)間間隔對(duì)象。這里就不提供例子了。

datetime類
datetime是date與time的結(jié)合體，包括date與time的所有信息。它的構(gòu)造函數(shù)如下：datetime.datetime(year, month, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]])，各參數(shù)的含義與date、time的構(gòu)造函數(shù)中的一樣，要注意參數(shù)值的范圍。

datetime類定義的類屬性與方法：

•datetime.min、datetime.max：datetime所能表示的最小值與最大值；
•datetime.resolution：datetime最小單位；
•datetime.today()：返回一個(gè)表示當(dāng)前本地時(shí)間的datetime對(duì)象；
•datetime.now([tz])：返回一個(gè)表示當(dāng)前本地時(shí)間的datetime對(duì)象，如果提供了參數(shù)tz，則獲取tz參數(shù)所指時(shí)區(qū)的本地時(shí)間；
•datetime.utcnow()：返回一個(gè)當(dāng)前utc時(shí)間的datetime對(duì)象；
•datetime.fromtimestamp(timestamp[, tz])：根據(jù)時(shí)間戮創(chuàng)建一個(gè)datetime對(duì)象，參數(shù)tz指定時(shí)區(qū)信息；
•datetime.utcfromtimestamp(timestamp)：根據(jù)時(shí)間戮創(chuàng)建一個(gè)datetime對(duì)象；
•datetime.combine(date, time)：根據(jù)date和time，創(chuàng)建一個(gè)datetime對(duì)象；
•datetime.strptime(date_string, format)：將格式字符串轉(zhuǎn)換為datetime對(duì)象；

使用例子：

復(fù)制代碼代碼如下:

 
from datetime import * 
import time 

print 'datetime.max:', datetime.max 
print 'datetime.min:', datetime.min 
print 'datetime.resolution:', datetime.resolution 
print 'today():', datetime.today() 
print 'now():', datetime.now() 
print 'utcnow():', datetime.utcnow() 
print 'fromtimestamp(tmstmp):', datetime.fromtimestamp(time.time()) 
print 'utcfromtimestamp(tmstmp):', datetime.utcfromtimestamp(time.time()) 

# ---- 結(jié)果 ---- 
# datetime.max: 9999-12-31 23:59:59.999999 
# datetime.min: 0001-01-01 00:00:00 
# datetime.resolution: 0:00:00.000001 
# today(): 2010-04-07 09:48:16.234000 
# now(): 2010-04-07 09:48:16.234000 
# utcnow(): 2010-04-07 01:48:16.234000 # 中國(guó)位于+8時(shí)間，與本地時(shí)間相差8 
# fromtimestamp(tmstmp): 2010-04-07 09:48:16.234000 
# utcfromtimestamp(tmstmp): 2010-04-07 01:48:16.234000 

datetime類提供的實(shí)例方法與屬性（很多屬性或方法在date和time中已經(jīng)出現(xiàn)過，在此有類似的意義，這里只羅列這些方法名，具體含義不再逐個(gè)展開介紹，可以參考上文對(duì)date與time類的講解。）：

•datetime.year、month、day、hour、minute、second、microsecond、tzinfo：
•datetime.date()：獲取date對(duì)象；
•datetime.time()：獲取time對(duì)象；
•datetime.replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]])：
•datetime.timetuple()
•datetime.utctimetuple()
•datetime.toordinal()
•datetime.weekday()
•datetime.isocalendar()
•datetime.isoformat([sep])
•datetime.ctime()：返回一個(gè)日期時(shí)間的C格式字符串，等效于time.ctime(time.mktime(dt.timetuple()))；
•datetime.strftime(format)
像date一樣，也可以對(duì)兩個(gè)datetime對(duì)象進(jìn)行比較，或者相減返回一個(gè)時(shí)間間隔對(duì)象，或者日期時(shí)間加上一個(gè)間隔返回一個(gè)新的日期時(shí)間對(duì)象。這里不提供詳細(xì)的例子，看客自己動(dòng)手試一下~~

格式字符串
datetime、date、time都提供了strftime()方法，該方法接收一個(gè)格式字符串，輸出日期時(shí)間的字符串表示。下表是從python手冊(cè)中拉過來的，我對(duì)些進(jìn)行了簡(jiǎn)單的翻譯（翻譯的有點(diǎn)噢口~~）。

格式字符意義

%a星期的簡(jiǎn)寫。如星期三為Web
%A星期的全寫。如星期三為Wednesday
%b月份的簡(jiǎn)寫。如4月份為Apr
%B月份的全寫。如4月份為April
%c: 日期時(shí)間的字符串表示。（如： 04/07/10 10:43:39）
%d: 日在這個(gè)月中的天數(shù)（是這個(gè)月的第幾天）
%f: 微秒（范圍[0,999999]）
%H: 小時(shí)（24小時(shí)制，[0, 23]）
%I: 小時(shí)（12小時(shí)制，[0, 11]）
%j: 日在年中的天數(shù) [001,366]（是當(dāng)年的第幾天）
%m: 月份（[01,12]）
%M: 分鐘（[00,59]）
%p: AM或者PM
%S: 秒（范圍為[00,61]，為什么不是[00, 59]，參考python手冊(cè)~_~）
%U: 周在當(dāng)年的周數(shù)當(dāng)年的第幾周），星期天作為周的第一天
%w: 今天在這周的天數(shù)，范圍為[0, 6]，6表示星期天
%W: 周在當(dāng)年的周數(shù)（是當(dāng)年的第幾周），星期一作為周的第一天
%x: 日期字符串（如：04/07/10）
%X: 時(shí)間字符串（如：10:43:39）
%y: 2個(gè)數(shù)字表示的年份
%Y: 4個(gè)數(shù)字表示的年份
%z: 與utc時(shí)間的間隔（如果是本地時(shí)間，返回空字符串）
%Z: 時(shí)區(qū)名稱（如果是本地時(shí)間，返回空字符串）
%%: %% => %

例子：

復(fù)制代碼代碼如下:

 
dt = datetime.now() 
print '(%Y-%m-%d %H:%M:%S %f): ', dt.strftime('%Y-%m-%d %H:%M:%S %f') 
print '(%Y-%m-%d %H:%M:%S %p): ', dt.strftime('%y-%m-%d %I:%M:%S %p') 
print '%%a: %s ' % dt.strftime('%a') 
print '%%A: %s ' % dt.strftime('%A') 
print '%%b: %s ' % dt.strftime('%b') 
print '%%B: %s ' % dt.strftime('%B') 
print '日期時(shí)間%%c: %s ' % dt.strftime('%c') 
print '日期%%x：%s ' % dt.strftime('%x') 
print '時(shí)間%%X：%s ' % dt.strftime('%X') 
print '今天是這周的第%s天 ' % dt.strftime('%w') 
print '今天是今年的第%s天 ' % dt.strftime('%j') 
print '今周是今年的第%s周 ' % dt.strftime('%U') 

# # ---- 結(jié)果 ---- 
# (%Y-%m-%d %H:%M:%S %f): 2010-04-07 10:52:18 937000 
# (%Y-%m-%d %H:%M:%S %p): 10-04-07 10:52:18 AM 
# %a: Wed 
# %A: Wednesday 
# %b: Apr 
# %B: April 
# 日期時(shí)間%c: 04/07/10 10:52:18 
# 日期%x：04/07/10 
# 時(shí)間%X：10:52:18 
# 今天是這周的第3天 
# 今天是今年的第097天 
# 今周是今年的第14周 