【Python】日期模块总结

Time Tuple:

索引	字段	值
0	年（四位数字）	2015
1	月份	1 - 12
2	日期	1 - 31
3	小时	0 - 23
4	分钟	0 - 59
5	秒	0 - 61 (60 或 61是闰秒)
6	星期	0 - 6 (0 为星期一)
7	一年中的第几天	1 - 366 (Julian日期)
8	夏令时	-1, 0, 1, -1 表示库决定DST

上面的元组相当于struct_time结构， 结构属性如下：

索引	属性	值
0	tm_year	2018
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 (60 或 61 是闰秒)
6	tm_wday	0 to 6 (0 为星期一)
7	tm_yday	1 to 366 (Julian日期)
8	tm_isdst	-1, 0, 1, -1 表示库决定DST

time 模块

SN	方法及描述
1	time.altzone 当地DST时区的偏移量，如果一个定义在UTC西部秒钟。这是负值，如果当地的DST时区为UTC东边（如西欧，包括英国）。如果白天不为零只用这个。
2	time.asctime([tupletime]) 接受一个时间元组，并返回一个可读的24个字符的字符串，如“Tue Dec 11 18:07:14 2015'。
3	time.clock( ) 返回当前CPU时间为几秒钟的浮点数。以测量不同方法的计算成本，time.clock的值比time.time()更有用
4	time.ctime([secs]) 类似asctimeasctime(localtime(secs))，不带参数就像asctime()
5	time.gmtime([secs]) 接收表示从epoch秒钟的瞬间，并返回一个时间元组t及UTC时间。注意：t.tm_isdst始终为0
6	time.localtime([secs]) 接收表示从epoch秒钟的瞬间，并返回一个时间元组t与被本地时间（t.tm_isdst是0或1，这取决于是否DST的适用于即时秒通过本地规则）
7	time.mktime(tupletime) 接受表示为一个时间的元组中的本地时间瞬间，并返回浮点值从epoch以秒表示的时刻
8	time.sleep(secs) 暂停secs秒钟调用线程
9	time.strftime(fmt[,tupletime]) 接收表示为一个时间的元组中的本地时间瞬间并返回表示所指定的字符串fmt瞬间的字符串
10	time.strptime(str,fmt='%a %b %d %H:%M:%S %Y') 根据格式字符串格式化解析str并返回时间元组格式
11	time.time( ) 返回当前时刻，自时代浮点秒数
12	time.tzset() 重置所使用的库例程的时间转换规则。环境变量TZ指定如何完成此操作。

datetime模块

 # -*- coding: utf-8 -*-

 #datetime类
 #datetime是date与time的结合体，包括date与time的所有信息。
 #它的构造函数如下：
 #datetime. datetime (year, month, day[ , hour[ , minute[ , second[ , microsecond[ , tzinfo] ] ] ] ] )
 #各参数的含义与date、time的构造函数中的一样，要注意参数值的范围。

# 1. datetime类定义的类属性与方法：
#datetime.min、datetime.max：datetime所能表示的最小值与最大值；
#print: datetime.max: 9999-12-31 23:59:59.999999
#print: datetime.min: 0001-01-01 00:00:00
from  datetime  import  *
import time
print   'datetime.max:' , datetime.max
print   'datetime.min:' , datetime.min
#datetime.resolution：datetime最小单位；
#print: datetime.resolution: 0:00:00.000001
print   'datetime.resolution:' , datetime.resolution
#datetime.today()：返回一个表示当前本地时间的datetime对象；
#print: today(): 2012-09-12 19:37:50.721000
print   'today():' , datetime.today()
#datetime.now([tz])：返回一个表示当前本地时间的datetime对象，如果提供了参数tz，则获取tz参数所指时区的本地时间；
#print: now(): 2012-09-12 19:37:50.738000
print   'now():' , datetime.now()
#datetime.utcnow()：返回一个当前utc时间的datetime对象；
#print: 2012-09-12 11:37:50.739000
print   'utcnow():' , datetime.utcnow()
#datetime.fromtimestamp(timestamp[, tz])：根据时间戮创建一个datetime对象，参数tz指定时区信息；
#print: fromtimestamp(tmstmp): 2012-09-12 19:37:50.741000
print   'fromtimestamp(tmstmp):' , datetime.fromtimestamp(time.time())
#datetime.utcfromtimestamp(timestamp)：根据时间戮创建一个datetime对象；
#print: utcfromtimestamp(tmstmp): 2012-09-12 11:37:50.742000
print   'utcfromtimestamp(tmstmp):' , datetime.utcfromtimestamp(time.time())
#datetime.combine(date, time)：根据date和time，创建一个datetime对象；
#print: datetime.combine(date,time):  2012-09-12 19:46:05
d = date(2012,9,12)
from  datetime  import  *
t = time(19,46,5)
print 'datetime.combine(date,time): ',datetime.combine(d,t)
#datetime.strptime(date_string, format)：将格式字符串转换为datetime对象；
#print: 2007-03-04 21:08:12
print datetime.strptime("2007-03-04 21:08:12", "%Y-%m-%d %H:%M:%S")

#2. datetime类提供的实例方法与属性
dt = datetime.strptime("2012-09-12 21:08:12", "%Y-%m-%d %H:%M:%S")
#print: 2012 9 12 21 8 12 0 None
print dt.year,dt.month,dt.day,dt.hour,dt.minute,dt.second,dt.microsecond,dt.tzinfo
print dt.date()
print dt.time()
print dt.replace(year = 2013)
print dt.timetuple()
print dt.utctimetuple()
print dt.toordinal()
print dt.weekday()
print dt.isocalendar()
#print dt.isoformat([sep])
#datetime. ctime ()：返回一个日期时间的C格式字符串，等效于time.ctime(time.mktime(dt.timetuple()))；

#3. 格式字符串
# datetime. strftime (format)
# %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):  2012-09-12 23:04:27 145000
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):  12-09-12 11:04:27 PM
print '(%Y-%m-%d %H:%M:%S %p): ', dt.strftime('%y-%m-%d %I:%M:%S %p')
#print: %a: Wed
print '%%a: %s ' % dt.strftime('%a')
#print: %A: Wednesday
print '%%A: %s ' % dt.strftime('%A')
#print: %b: Sep
print '%%b: %s ' % dt.strftime('%b')
#print: %B: September
print '%%B: %s ' % dt.strftime('%B')
#print: 日期时间%c: 09/12/12 23:04:27
print '日期时间%%c: %s ' % dt.strftime('%c')
#print: 日期%x：09/12/12
print '日期%%x：%s ' % dt.strftime('%x')
#print: 时间%X：23:04:27
print '时间%%X：%s ' % dt.strftime('%X')
#print: 今天是这周的第3天
print '今天是这周的第%s天 ' % dt.strftime('%w')
#print: 今天是今年的第256天
print '今天是今年的第%s天 ' % dt.strftime('%j')
#print: 今周是今年的第37周
print '今周是今年的第%s周 ' % dt.strftime('%U')

注: 获取日期是周几：weekday()方法可以获得datetime是星期几,注意weekday() 返回的是0-6是星期一到星期日

 import datetime

 print datetime.datetime.now().weekday()

calendar 模块

SN	方法及描述
1	calendar.calendar(year,w=2,l=1,c=6) 返回为多行字符串的逐年日历格式化成用c空格分隔的三列。 w是中的每一个日期字符的宽度;每行的长度为21* w +18+2* c。 l为每个星期的行数。
2	calendar.firstweekday( ) 返回当前设置为每个星期开始工作日。默认情况下，当先导入calendar，这是0，意思是星期一。
3	calendar.isleap(year) 如果今年是闰年返回true，否则为false。
4	calendar.leapdays(y1,y2) 返回范围内的总数在range(y1,y2)。
5	calendar.month(year,month,w=2,l=1) 返回为多行字符串与日历月month年year，每周一条线加上两个标题行。 w是中的每一个日期字符的宽度;每行的长度为7* W +6。 l为每个星期的行数。
6	calendar.monthcalendar(year,month) 返回整数的列表。每个子列表表示一个星期。月month年year都设置为0;在一个月内，day都被设置为一天，月份，1及以上的数字。
7	calendar.monthrange(year,month) 返回两个整数。第一个是星期几月month年year的第一天的代码;第二个是在所述月份的天数。星期代码是0（星期一）至6日（星期日）;月数是1〜12。
8	calendar.prcal(year,w=2,l=1,c=6) 打印类似calendar.calendar(year,w,l,c).
9	calendar.prmonth(year,month,w=2,l=1) 打印类似calendar.month(year,month,w,l).
10	calendar.setfirstweekday(weekday) 将每个星期的第一天工作日代码设置。星期代码是0（星期一）至6日（星期日）。
11	calendar.timegm(tupletime) time.gmtime的反向：接受一个时刻在时间元组的形式，并返回同一时刻为从epoch浮点秒数。
12	calendar.weekday(year,month,day) 返回给定日期的星期代码。星期代码0（星期一）至6日（星期日）;月份数字代码为1（一月）到12（12月）。

　关于dateutil模块，后续再总结。

Refer:

• http://blog.csdn.net/wirelessqa/article/details/7973121
• http://www.cnblogs.com/emanlee/p/4399147.html
• http://www.yiibai.com/python/python_date_time.html
• http://labix.org/python-dateutil