python stl文件_Python STL datetime

作用：datetime模块包含一些函数和类，用于完成日期和时间解析、格式化和算术运算。

Python版本：2.3及以后版本

datetime包含一些用于处理日期和时间的函数和类，这些函数和类可以单独使用，也可以结合使用。

模块概览

datetime 主要有三个模块

time

date

datetime

时间

时间值用time类表示。time实例包含hour、minute、second和microsecond属性，还可以包含时区信息。

In [7]: import datetime

In [8]: t = datetime.time(1, 2, 3)

In [9]: t

Out[9]: datetime.time(1, 2, 3)

In [10]: t.hour

Out[10]: 1

In [11]: t.minute

Out[11]: 2

In [12]: t.second

Out[12]: 3

In [13]: t.microsecond

Out[13]: 0

In [14]: t.tzinfo

初始化time实例的参数是可选的，不过默认值0往往不会是正确的设置。

time实例只包含时间值，而不包含与时间关联的日期值。min和max类属性可以反映一天中的合法时间范围

In [15]: datetime.time.min

Out[15]: datetime.time(0, 0)

In [16]: datetime.time.max

Out[16]: datetime.time(23, 59, 59, 999999)

In [17]: datetime.time.resolution

Out[17]: datetime.timedelta(0, 0, 1)

In [18]: print(datetime.time.resolution)

0:00:00.000001

time的分辨率限制为整毫秒值。

处理浮点数值的方式取决于Python的版本。版本2.7会产生一个TypeError,而更早的版本会生成一个DeprecationWaming,并把浮点数转换为一个整数。

import datetime

for m in [ 1, 0, 0.1, 0.6 ]:

try:

print '%02.1f:' % m, datetime.time(0, 0, 0, microsecond=m)

except TypeError, err:

print 'ERROR:', err

python2.7

python2.6

日期

日历日期值用date类表示。date实例包含year、month和day属性。使用today〇类方法很 容易创建一个表示当前日期的日期实例

In [25]: today = datetime.date.today()

In [26]: today.ctime()

Out[26]: 'Fri Feb 23 00:00:00 2018'

In [27]: tt = today.timetuple()

In [28]: for i in tt:

...: print(i)

...:

2018

2

23

0

0

0

4

54

-1

In [29]: type(tt)

Out[29]: time.struct_time

In [30]: today.toordinal()

Out[30]: 736748

In [31]: today.year

Out[31]: 2018

In [32]: today.month

Out[32]: 2

In [33]: today.day

Out[33]: 23

还有一些类方法可以由POSIX时间戳或表示Gregorian日历中日期值的整数(第1年的1月1日对应的整数为1,以后每天对应的值相应增1)来创建date实例,

import datetime

import time

o = 733114

print 'o :', o

print 'fromordinal(o) :', datetime.date.fromordinal(o)

t = time.time()

print 't :', t

print 'fromtimestamp(t):', datetime.date.fromtimestamp(t)

这个例子表明fromordinal()和fromtimestamp()使用了不同的值类型

o : 733114

fromordinal(o) : 2008-03-13

t : 1519368051.68

fromtimestamp(t): 2018-02-23

[Finished in 0.1s]

与time类似，可以使用min和max属性确定所支持的日期值范围。

import datetime

print 'Earliest :', datetime.date.min

print 'Latest :', datetime.date.max

print 'Resolution:', datetime.date.resolution

日期的分辨串为整天。

Earliest : 0001-01-01

Latest : 9999-12-31

Resolution: 1 day, 0:00:00

[Finished in 0.1s]

创建新的date实例还有一种方法，可以使用一个现有date的replace方法来创建。

import datetime

d1 = datetime.date(2008, 3, 29)

print 'd1:', d1.ctime()

d2 = d1.replace(year=2009)

print 'd2:', d2.ctime()

这个例子会改变年，但日和月保持不变。

d1: Sat Mar 29 00:00:00 2008

d2: Sun Mar 29 00:00:00 2009

[Finished in 0.1s]

增量

通过对两个datetime对象使用算术运算，或者结合使用一个datetime和一个timedelta,可以计算出将来和过去的一些日期将两个日期相减可以生成一个timedelta,还可以对某个日期增加或减去一个timedelta来生成另一个日期。timedelta的内部值按日、秒和亳秒存储。

import datetime

print "microseconds:", datetime.timedelta(microseconds=1)

print "milliseconds:", datetime.timedelta(milliseconds=1)

print "seconds :", datetime.timedelta(seconds=1)

print "minutes :", datetime.timedelta(minutes=1)

print "hours :", datetime.timedelta(hours=1)

print "days :", datetime.timedelta(days=1)

print "weeks :", datetime.timedelta(weeks=1)

传入构造函数的中间值会转换为日、秒和毫秒。

microseconds: 0:00:00.000001

milliseconds: 0:00:00.001000

seconds : 0:00:01

minutes : 0:01:00

hours : 1:00:00

days : 1 day, 0:00:00

weeks : 7 days, 0:00:00

[Finished in 0.1s]

一个timedelta的完整时间段可以使用total_seconds()得到，作为一个秒数返回。

import datetime

for delta in [datetime.timedelta(microseconds=1),

datetime.timedelta(milliseconds=1),

datetime.timedelta(seconds=1),

datetime.timedelta(minutes=1),

datetime.timedelta(hours=1),

datetime.timedelta(days=1),

datetime.timedelta(weeks=1),

]:

print '%15s=%sseconds' % (delta, delta.total_seconds())

返回值是一个浮点数，因为有些时间段不到1秒.

0:00:00.000001 = 1e-06 seconds

0:00:00.001000 = 0.001 seconds

0:00:01 = 1.0 seconds

0:01:00 = 60.0 seconds

1:00:00 = 3600.0 seconds

1 day, 0:00:00 = 86400.0 seconds

7 days, 0:00:00 = 604800.0 seconds

[Finished in 0.1s]

运算

日期算术运算使用标准算术操作符来完成。

import datetime

today = datetime.date.today()

print 'Today :', today

one_day = datetime.timedelta(days=1)

print 'One day :', one_day

yesterday = today - one_day

print 'Yesterday:', yesterday

tomorrow = today + one_day

print 'Tomorrow :', tomorrow

print

print 'tomorrow - yesterday:', tomorrow - yesterday

print 'yesterday - tomorrow:', yesterday - tomorrow

这个处理日期对象的例子展示了使用timedelta对象来计算新日期，以及将日期实例相减来生成timedelta (包括一个负差异值)。

Today : 2018-02-23

One day : 1 day, 0:00:00

Yesterday: 2018-02-22

Tomorrow : 2018-02-24

tomorrow - yesterday: 2 days, 0:00:00

yesterday - tomorrow: -2 days, 0:00:00

[Finished in 0.1s]

比较

日期和时间值都可以使用标准比较操作符来比较，确定哪一个在前或在后。

import datetime

print 'Times:'

t1 = datetime.time(12, 55, 0)

print ' t1:', t1

t2 = datetime.time(13, 5, 0)

print ' t2:', t2

print ' t1 < t2:', t1 < t2

print

print 'Dates:'

d1 = datetime.date.today()

print ' d1:', d1

d2 = datetime.date.today() + datetime.timedelta(days=1)

print ' d2:', d2

print ' d1 > d2:', d1 > d2

所有比较操作符都得到支持

Times:

t1: 12:55:00

t2: 13:05:00

t1 < t2: True

Dates:

d1: 2018-02-23

d2: 2018-02-24

d1 > d2: False

[Finished in 0.1s]

结合

使用datetime类可以存储由日期和时间分量构成的值。类似于date,可以使用很多便利的类方法由其他常用值创建datetime实例。

import datetime

print 'Now :', datetime.datetime.now()

print 'Today :', datetime.datetime.today()

print 'UTC Now:', datetime.datetime.utcnow()

print

FIELDS = [ 'year', 'month', 'day',

'hour', 'minute', 'second', 'microsecond',

]

d = datetime.datetime.now()

for attr in FIELDS:

print '%15s:%s' % (attr, getattr(d, attr))

可以看到，datetime实例包含date和time对象的所有属性。

Now : 2018-02-23 14:56:09.960000

Today : 2018-02-23 14:56:09.960000

UTC Now: 2018-02-23 06:56:09.960000

year: 2018

month: 2

day: 23

hour: 14

minute: 56

second: 9

microsecond: 960000

[Finished in 0.1s]

与date类似，datetime提供了方便的类方法来创建新实例。它还包括fromordinal和fromtimestamp

import datetime

t = datetime.time(1, 2, 3)

print 't :', t

d = datetime.date.today()

print 'd :', d

dt = datetime.datetime.combine(d, t)

print 'dt:', dt

利用combine,可以由一个date实例和一个time实例创建一个datetime实例。

t : 01:02:03

d : 2018-02-23

dt: 2018-02-23 01:02:03

[Finished in 0.1s]

格式化和解析

datetime对象的默认字符串表示使用ISO-8601格式(YYYY-MM-DDTHH:MM:SS.mmmmmm)。可以使用strftime()生成其他格式。

import datetime

format = "%a %b%d%H:%M:%S %Y"

today = datetime.datetime.today()

print 'ISO :', today

s = today.strftime(format)

print 'strftime:', s

d = datetime.datetime.strptime(s, format)

print 'strptime:', d.strftime(format)

使用datetime.strptime()可以将格式化的字符串转换为datetime实例

ISO : 2018-02-23 14:59:50.899000

strftime: Fri Feb 23 14:59:50 2018

strptime: Fri Feb 23 14:59:50 2018

[Finished in 0.1s]

时区

在datetime中，时区由tzinfo的子类表示，由于tzinfo是一个抽象基类，实际使用时，应用需要定义它的一个子类，并提供一些方法的适当的表示。遗憾的是，datetime未包含任何可 供使用的具体实现(不过文档提供了一些示例实现)。可以参考标准库文档页面，其中有一些 使用固定偏移的例子，还可以从中了解一个有关DST的类以及创建定制时区类的更多详细信息。pytz也是一个了解时区实现细节的很好的资源。