5.1.4 datetime对象

类datetime创建的对象包括了日期和时间相关信息。
class datetime.datetime(year, month, day, hour=0, minute=0, second=0, microsecond=0, tzinfo=None)
构造一个datetime对象，需要输入年、月、日三个参数，其它参数都是可选。输入的参数应满足下面的范围：
l MINYEAR <= year <= MAXYEAR
l 1 <= month <= 12
l 1 <= day <= 小于指定月份的天数
l 0 <= hour < 24
l 0 <= minute < 60
l 0 <= second < 60
l 0 <= microsecond < 1000000
如果输入的值超出范围，就会抛出异常ValueError。
 
classmethod datetime.today() 
从当前时间构造一个datetime对象，返回当前日期和时间，但tzinfo设置为None。相当于datetime.fromtimestamp(time.time())。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
print('to:', to)
结果输出如下：
to: 2015-11-04 09:45:54.856671
 
classmethod datetime.now(tz=None) 
返回当前日期和时间的datetime对象。如果参数tz没有指定，它相当于today()函数的功能。如果指定tz为tzinfo对象时区，就会把当前日期和时间转换为对应时区的日期和时间。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.now()
print('to:', to)
结果输出如下：
to: 2015-11-04 14:05:16.029719
 
classmethod datetime.utcnow() 
返回UTC的日期和时间，时区tzinfo为None。相当于datetime.now(timezone.utc)。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.now(datetime.timezone.utc)
utc = datetime.datetime.utcnow()
print('to:', to)
print('utc:', utc)
结果输出如下：
to: 2015-11-05 01:37:55.466599+00:00
utc: 2015-11-05 01:37:55.466599
 
classmethod datetime.fromtimestamp(timestamp, tz=None) 
从一个POSIX的时间字符串构造日期和时间对象返回，比如从time.time()。如果tz为None，从本地时区作转换，如果指定时区就根据指定时区来转换时间。如果超出了范围，就会抛出异常OverflowError。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.fromtimestamp(10000)
print('to:', to)
结果输出如下：
to: 1970-01-01 10:46:40
 
classmethod datetime.utcfromtimestamp(timestamp) 
返回UTC的POSIX的日期和时间，并且tzinfo设置为None。相当于：
datetime(1970, 1, 1) + timedelta(seconds=timestamp)
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.fromtimestamp(10000)
utc = datetime.datetime.utcfromtimestamp(10000)
print('to:', to)
print('utc:', utc)
结果输出如下：
to: 1970-01-01 10:46:40
utc: 1970-01-01 02:46:40
 
classmethod datetime.fromordinal(ordinal) 
从天序数来生成日期，0年1月1日作为第1天。如果超出表示范围抛出异常ValueError。默认时、分、秒和微秒都是0， 时区tzinfo设置为None。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.fromordinal(10000)
print('to:', to)
结果输出如下：
to: 0028-05-18 00:00:00
 
classmethod datetime.combine(date, time) 
组合date和time对象为一个datetime对象，日期使用date对象，时间使用time对象，时区也是使用time对象。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
to = datetime.datetime.combine(to.date(), to.timetz())
print('to:', to)
结果输出如下：
to: 2015-11-06 08:39:43.202053
 
classmethod datetime.strptime(date_string, format) 
根据格式format来分析时间字符串date_string，然后生成一个datetime对象返回。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
strTime = to.strftime("%A %d. %B %Y")
to = datetime.datetime.strptime(strTime, "%A %d. %B %Y")
print('to:', to)
结果输出如下：
to: 2015-11-06 00:00:00
 
datetime的类型属性：
datetime.min 
表示最小的日期时间，datetime(MINYEAR, 1, 1, tzinfo=None)。
 
datetime.max 
表示最大的日期时间datetime(MAXYEAR, 12, 31, 23, 59, 59, 999999, tzinfo=None)。
 
datetime.resolution 
表示两个日期时间对象之间最小差值，timedelta(microseconds=1)。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
print('min:', to.min)
print('max:', to.max)
print('resolution:', to.resolution)
结果输出如下：
min: 0001-01-01 00:00:00
max: 9999-12-31 23:59:59.999999
resolution: 0:00:00.000001
 
datetime类实例属性：
datetime.year 
表示范围在MINYEAR和MAXYEAR之间。
 
datetime.month 
表示范围在1和12之间。
 
datetime.day 
表示范围在1和给出年的月份总天数之间。
 
datetime.hour 
表示24小时。
 
datetime.minute 
表示范围60。
 
datetime.second 
表示范围60。
 
datetime.microsecond 
表示范围为1000000。
 
datetime.tzinfo 
表示时间区。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
print('year:', to.year)
print('month:', to.month)
print('day:', to.day)
print('hour:', to.hour)
print('minute:', to.minute)
print('second:', to.second)
print('microsecond:', to.microsecond)
print('tzinfo:', to.tzinfo)
结果输出如下：
year: 2015
month: 11
day: 6
hour: 9
minute: 54
second: 28
microsecond: 146576
tzinfo: None
 
datetime对象支持操作：
日期时间对象与时间变量相加datetime2 = datetime1 + timedelta
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
td = datetime.timedelta(10)
print('to:', to)
to = to + td
print('to+td:', to)
结果输出如下：
to: 2015-11-06 10:21:16.326559
to+td: 2015-11-16 10:21:16.326559
 
日期时间对象与时间变量相减datetime2 = datetime1 - timedelta
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
td = datetime.timedelta(10)
print('to:', to)
to = to - td
print('to-td:', to)
结果输出如下：
to: 2015-11-09 14:17:47.119363
to-td: 2015-10-30 14:17:47.119363
 
两个日期时间相减得到时间差值timedelta = datetime1 - datetime2
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
dt = datetime.datetime(2015, 11, 11)
print('to:', to)
td = to - dt
print('to-td:', td)
结果输出如下：
to: 2015-11-12 08:31:33.137212
to-td: 1 day, 8:31:33.137212
 
日期时间对象进行比较datetime1 < datetime2
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
dt = datetime.datetime(2015, 11, 11)
print('to:', to)
print('to > dt:', to > dt)
结果输出如下：
to: 2015-11-12 11:03:44.813513
to > dt: True
 
datetime实例拥有方法：
datetime.date() 
返回date对象表示年、月和日。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
 
print('to.date():', to.date())
结果输出如下：
to.date(): 2015-11-12
 
datetime.time() 
返回time对象，表示同样的时、分、秒和微秒。tzinfo为None。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
print('to.time():', to.time())
结果输出如下：
to.time(): 11:31:57.696341
 
datetime.timetz() 
返回time对象，表示同样的时、分、秒和微秒，也包括tzinfo属性。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
print('to.timetz():', to.timetz())
结果输出如下：
to.timetz(): 11:39:20.299655
 
datetime.replace([year[, month[, day[, hour[, minute[, second[, microsecond[, tzinfo]]]]]]]]) 
返回一个datetime对象，除了输入相应参数的值修改之外，其它值与实例对象相同。
例子：
#python 3.4.3
import datetime
 
to = datetime.datetime.today()
new = to.replace(year = 2014)
print('to:', to)
print('new:', new)
结果输出如下：
to: 2015-11-12 11:42:49.940646
new: 2014-11-12 11:42:49.940646
 
datetime.astimezone(tz=None) 
返回一个指定的时区变换的datetime对象。
例子：
#python 3.4.3
import datetime
from pytz import timezone
 
la = timezone('America/Los_Angeles')
dt = la.localize(datetime.datetime(2015, 11, 11, 1, 2, 3))
fmt = '%Y-%m-%d %H:%M:%S %Z (%z)'
gmt = timezone('GMT')
gmt.normalize(dt).strftime(fmt)
new = dt.astimezone()
print('new:', new)
结果输出如下：
new: 2015-11-12 01:02:03+16:00
 
datetime.utcoffset() 
如果tzinfo是None返回None；否则返回self.tzinfo.utcoffset(self)。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.today()
new = dt.utcoffset()
print('new:', new)
结果输出如下：
new: None
 
datetime.dst() 
如果tzinfo是None，返回None；如果非空则返回self.tzinfo.dst(self)。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.today()
new = dt.dst()
print('new:', new)
结果输出如下：
new: None
 
datetime.tzname() 
如果tzinfo是None，否则返回self.tzinfo.tzname(self)。
例子如下：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
new = dt.tzname()
print('new:', new)
结果输出如下：
new: UTC+00:00
 
datetime.timetuple() 
返回一个time.struct_time对象，与time.localtime()相同。d.timetuple()与time.struct_time((d.year, d.month, d.day, d.hour, d.minute, d.second, d.weekday(), yday, dst))相同。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
new = dt.timetuple()
print('new:', new)
结果输出如下：
new: time.struct_time(tm_year=2015, tm_mon=11, tm_mday=16, tm_hour=1, tm_min=26, tm_sec=55, tm_wday=0, tm_yday=320, tm_isdst=-1)
 
datetime.utctimetuple()  
如果对象非UTC时间，就会格式化为UTC时间，再返回time.struct_time对象。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
new = dt.timetuple()
print('new:', new)
utc = dt.utctimetuple()
print('utc:', utc)
结果输出如下：
new: time.struct_time(tm_year=2015, tm_mon=11, tm_mday=16, tm_hour=1, tm_min=34, tm_sec=42, tm_wday=0, tm_yday=320, tm_isdst=-1)
utc: time.struct_time(tm_year=2015, tm_mon=11, tm_mday=16, tm_hour=1, tm_min=34, tm_sec=42, tm_wday=0, tm_yday=320, tm_isdst=0)
 
datetime.toordinal() 
返回公历的开始的计算的天数。等同self.date().toordinal()。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
to = dt.toordinal()
print('to:', to)
结果输出如下：
to: 735918
 
datetime.timestamp() 
返回POSIX标准的时间，使用浮点数来表示已经经历多少秒。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
to = dt.timestamp()
print('to:', to)
结果输出如下：
to: 1447638918.534684
 
datetime.weekday() 
返回日期时间是一周里第几天，0表示周一，6表示是周日。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
to = dt.weekday()
print('to:', to)
结果输出如下：
to: 0
 
datetime.isoweekday() 
返回日期是一周里第几天，采用ISO标准表示，1是表示周一，7是表示周日。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
to = dt.isoweekday()
print('to:', to)
结果输出如下：
to: 1
 
datetime.isocalendar() 
返回三个元素（ISO标准的年，ISO标准的第几周，ISO标准的一周第几天）。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.now(datetime.timezone.utc)
to = dt.isocalendar()
print('to:', to)
结果输出如下：
to: (2015, 47, 1)
 
datetime.isoformat(sep='T') 
返回ISO8601格式的日期和时间，格式为：YYYY-MM-DDTHH:MM:SS.mmmmmm，或者当微秒为0时为YYYY-MM-DDTHH:MM:SS。如果utcoffset不返回None，则在时间后面添加符号的相对时间，格式为：YYYY-MM-DDTHH:MM:SS.mmmmmm+HH:MM ；当微秒为0时YYYY-MM-DDTHH:MM:SS+HH:MM。
参数sep是分隔日期和时间之间字符，默认为T。
例子：
#python 3.4.3
import datetime
 
class TZ(datetime.tzinfo):
    def utcoffset(self, dt): return datetime.timedelta(minutes=-399)
 
dt = datetime.datetime(2015, 12, 25, tzinfo=TZ()).isoformat(' ')
print('dt:', dt)
结果输出如下：
dt: 2015-12-25 00:00:00-06:39
 
datetime.__str__() 
返回日期时间的格式化字符串，str(d)等同d.isoformat(‘ ‘)。
例子：
#python 3.4.3
import datetime
 
class TZ(datetime.tzinfo):
    def utcoffset(self, dt): return datetime.timedelta(minutes=-399)
dt = datetime.datetime(2015, 12, 25, tzinfo=TZ())
print('dt:', str(dt))
结果输出如下：
dt: 2015-12-25 00:00:00-06:39
 
datetime.ctime() 
返回像C语言格式化的日期时间表示。
例子：
#python 3.4.3
import datetime
 
class TZ(datetime.tzinfo):
    def utcoffset(self, dt): return datetime.timedelta(minutes=-399)
dt = datetime.datetime(2015, 12, 25, tzinfo=TZ())
print('dt:', dt.ctime())
结果输出如下：
dt: Fri Dec 25 00:00:00 2015
 
datetime.strftime(format) 
通过指定的格式字符串来格式时间。它与strtime()和strptime()函数的格式相同。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.today()
print('dt:', dt.strftime("%A, %d. %B %Y %I:%M%p"))
结果输出如下：
dt: Monday, 16. November 2015 11:32AM
 
datetime.__format__(format)
返回格式与datetime.strftime()一样。
例子：
#python 3.4.3
import datetime
 
dt = datetime.datetime.today()
print('dt:', dt.__format__("%A, %d. %B %Y %I:%M%p"))
结果输出如下：
dt: Monday, 16. November 2015 11:50AM
 

蔡军生 QQ:9073204  深圳