datetime子產品定義了下面這幾個類:
datetime.date:表示日期的類。常用的屬性有year, month, day.datetime.time:表示時間的類。常用的屬性有hour, minute, second, microsecond.datetime.datetime:表示日期時間。datetime.timedelta:表示時間間隔,即兩個時間點之間的長度。datetime.tzinfo:與時區有關的相關資訊
datetime.date:表示日期的類。常用的屬性有year, month, day.datetime.time:表示時間的類。常用的屬性有hour, minute, second, microsecond.datetime.datetime:表示日期時間。datetime.timedelta:表示時間間隔,即兩個時間點之間的長度。datetime.tzinfo:與時區有關的相關資訊。(這裡不詳細充分讨論該類,感興趣的童鞋可以參考python手冊)
注 :上面這些類型的對象都是不可變(immutable)的。
下面詳細介紹這些類的使用方式。
date類
date類表示一個日期。日期由年,月,日組成。
date類的構造函數如下:
class datetime.date(year, month, day):
注意:
year的範圍是[MINYEAR, MAXYEAR],即[1, 9999]
month的範圍是[1, 12]
day的最大值根據給定的year, month參數來決定。例如閏年2月份有29天.
date類定義一些常用的類方法與類屬性l:
date.max、date.min:
date對象所能表示的最大、最小日期.
date.resolution: date對象表示日期的最小機關。
date.today():傳回一個表示目前本地日期的date對象.
date.fromtimestamp(timestamp): 根據給定的時間戮,傳回一個date對象.
datetime.fromordinal(ordinal):将Gregorian月曆時間轉換為date對象.
date提供的執行個體方法和屬性:
date.year,date.month,date.day:年,月,日.
date.replace(year, month, day):生成一個新的日期對象,用參數指定的年,月,日代替原有對象中的屬性。
原有對象仍保持不變
date.timetuple(): 傳回日期對應的time.struct_time對象.
date.toordinal(): 傳回日期對應的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):自定義格式化字元串。
date 還對某些操作進行了重載,它允許我們對日期進行如下一些操作:
date2 = date1 + timedelta # 日期加上一個間隔,傳回一個新的日期對象(timedelta将在下面介紹,表示時間間隔)
date2 = date1 - timedelta # 日期隔去間隔,傳回一個新的日期對象
timedelta = date1 - date2 # 兩個日期相減,傳回一個時間間隔對象
date1
注:對日期進行操作時,要防止日期超出它所能表示的範圍。
使用例子:
>>> now = date(2012, 02, 24)
>>> tomorrow = now.replace(day = 28)
>>> print 'now:', now, ', tomorrow:', tomorrow
now: 2012-02-24 , tomorrow: 2012-02-28
>>> print 'timetuple():', now.timetuple()
timetuple(): (2012, 2, 24, 0, 0, 0, 4, 55, -1)
>>> print 'weekday():', now.weekday()
weekday(): 4
>>> print 'isoweekday():', now.isoweekday()
isoweekday(): 5
>>> print 'isocalendar():', now.isocalendar()
isocalendar(): (2012, 8, 5)
>>> print 'isoformat():', now.isoformat()
isoformat(): 2012-02-24
Time類
time類表示時間,由時、分、秒以及微秒組成。
time類的構造函數如下:
class datetime.time(hour[ , minute[ , second[ , microsecond[ , tzinfo]]]] ) :
各參數的意義不作解釋,這裡留意一下參數tzinfo,它表示時區資訊。
注意一下各參數的取值範圍:
hour的範圍為[0, 24),minute的範圍為[0, 60),second的範圍為[0, 60),microsecond的範圍為[0, 1000000)。
time類定義的類屬性:
time.min、time.max:time類所能表示的最小、最大時間。
其中,time.min = time(0, 0, 0, 0), time.max = time(23, 59, 59, 999999).
time.resolution:時間的最小機關,這裡是1微秒.
time類提供的執行個體方法和屬性:
time.hour、time.minute、time.second、time.microsecond:時、分、秒、微秒.
time.tzinfo:時區資訊.
time.replace([ hour[ , minute[ , second[ , microsecond[ , tzinfo]]]]] ):建立一個新的時間對象,用參數指定的時、分、秒、微秒代替原有對象中的屬性(原有對象仍保持不變).
time.isoformat():傳回型如"HH:MM:SS"格式的字元串表示.
time.strftime(fmt):傳回自定義格式化字元串。在下面詳細介紹.
>>> from datetime import *
>>> tm = time(22, 19, 10)
>>> print 'tm:', tm
tm: 22:19:10
>>> print 'hour: %d, minute: %d, second: %d, microsecond: %d' \
... % (tm.hour, tm.minute, tm.second, tm.microsecond)
hour: 22, minute: 19, second: 10, microsecond: 0
>>> tm1 = tm.replace(hour = 20)
>>> print 'tm1:', tm1
tm1: 20:19:10
>>> print 'isoformat():', tm.isoformat()
isoformat(): 22:19:10
像date一樣,也可以對兩個time對象進行比較,或者相減傳回一個時間間隔對象。這裡就不提供例子了。
datetime類
datetime是date與time的結合體,包括date與time的所有資訊。它的構造函數如下:datetime.datetime (year, month, day[ , hour[ , minute[ , second[ , microsecond[ , tzinfo]]]]] ),各參數的含義與date、time的構造函數中的一樣,要注意參數值的範圍。
datetime類定義的類屬性與方法:
datetime.min、datetime.max:datetime所能表示的最小值與最大值;
datetime.resolution:datetime最小機關;
datetime.today():傳回一個表示目前本地時間的datetime對象;
datetime.now([tz]):傳回一個表示目前本地時間的datetime對象,如果提供了參數tz,則擷取tz參數所指時區的本地時間;
datetime.utcnow():傳回一個目前utc時間的datetime對象;
datetime.fromtimestamp(timestamp[, tz]):根據時間戮建立一個datetime對象,參數tz指定時區資訊;
datetime.utcfromtimestamp(timestamp):根據時間戮建立一個datetime對象;
datetime.combine(date, time):根據date和time,建立一個datetime對象;
datetime.strptime(date_string, format):将格式字元串轉換為datetime對象;
from datetime import *
import time
>>> print 'datetime.max:', datetime.max
datetime.max: 9999-12-31 23:59:59.999999
>>> print 'datetime.min:', datetime.min
datetime.min: 0001-01-01 00:00:00
>>> print 'datetime.resolution:', datetime.resolution
datetime.resolution: 0:00:00.000001
>>> print 'today():', datetime.today()
today(): 2012-02-24 22:17:36.945862
>>> print 'now():', datetime.now()
now(): 2012-02-24 22:17:36.966896
>>> print 'utcnow():', datetime.utcnow()
utcnow(): 2012-02-24 14:17:36.976883
datetime類提供的執行個體方法與屬性:
datetime.year、month、day、hour、minute、second、microsecond、tzinfo:datetime.date():擷取date對象;
datetime.time():擷取time對象;
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():傳回一個日期時間的C格式字元串,等效于time.ctime(time.mktime(dt.timetuple()));
datetime.strftime(format)
像date一樣,也可以對兩個datetime對象進行比較,或者相減傳回一個時間間隔對象,或者日期時間加上一個間隔傳回一個新的日期時間對象。
格式字元串
datetime、date、time都提供了strftime()方法,該方法接收一個格式字元串,輸出日期時間的字元串表示。
下表是從python手冊中拉過來的,我對些進行了簡單的翻譯。
格式字元 意義
%a星期的簡寫。如 星期三為Web
%A星期的全寫。如 星期三為Wednesday
%b月份的簡寫。如4月份為Apr
%B月份的全寫。如4月份為April
%c: 日期時間的字元串表示。(如: 04/07/10 10:43:39)
%d: 日在這個月中的天數(是這個月的第幾天)
%f: 微秒(範圍[0,999999])
%H: 小時(24小時制,[0, 23])
%I: 小時(12小時制,[0, 11])
%j: 日在年中的天數 [001,366](是當年的第幾天)
%m: 月份([01,12])
%M: 分鐘([00,59])
%p: AM或者PM
%S: 秒(範圍為[00,61],為什麼不是[00, 59],參考python手冊~_~)
%U: 周在當年的周數當年的第幾周),星期天作為周的第一天
%w: 今天在這周的天數,範圍為[0, 6],6表示星期天
%W: 周在當年的周數(是當年的第幾周),星期一作為周的第一天
%x: 日期字元串(如:04/07/10)
%X: 時間字元串(如:10:43:39)
%y: 2個數字表示的年份
%Y: 4個數字表示的年份
%z: 與utc時間的間隔 (如果是本地時間,傳回空字元串)
%Z: 時區名稱(如果是本地時間,傳回空字元串)
%%: %% => %
例子:
>>> dt = datetime.now()
>>> print '(%Y-%m-%d %H:%M:%S %f): ', dt.strftime('%Y-%m-%d %H:%M:%S %f')
(%Y-%m-%d %H:%M:%S %f): 2012-02-24 22:16:34 %f
>>> print '(%Y-%m-%d %H:%M:%S %p): ', dt.strftime('%y-%m-%d %I:%M:%S %p')
(%Y-%m-%d %H:%M:%S %p): 12-02-24 10:16:34 PM
>>> print '%%a: %s ' % dt.strftime('%a')
%a: Fri
>>> print '%%A: %s ' % dt.strftime('%A')
%A: Friday
>>> print '%%b: %s ' % dt.strftime('%b')
%b: Feb
>>> print '%%B: %s ' % dt.strftime('%B')
%B: February
>>> print '日期時間%%c: %s ' % dt.strftime('%c')
日期時間%c: Fri Feb 24 22:16:34 2012
>>> print '日期%%x:%s ' % dt.strftime('%x')
日期%x:02/24/12
>>> print '時間%%X:%s ' % dt.strftime('%X')
時間%X:22:16:34
>>> print '今天是這周的第%s天 ' % dt.strftime('%w')
今天是這周的第5天
>>> print '今天是今年的第%s天 ' % dt.strftime('%j')
今天是今年的第055天
>>> print '今周是今年的第%s周 ' % dt.strftime('%U')
今周是今年的第08周
>>>