Python datetime模块详解、示例和计算日期

1、datetime函数

1.1、datetime模块中包含如下类

1.2、datetime模块中包含的常量

2、date类

2.1、date对象的构成

date对象由**year年份、month月份及day**日期三部分构成：

2.2、date对象中包含的方法与属性

2.2.1、用于日期比较大小的方法

以上方法的返回值为True\False。

示例

a=datetime.date(2017, 3, 1)
b=datetime.date(2017, 3, 15)
# 返回值False
a.__eq__(b) 

# 返回值False
a.__ge__(b)

# 返回值False
a.__gt__(b)

# 返回值False
a.__le__(b)

# 返回值True
a.__lt__(b)

# 返回值True
a.__ne__(b)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

2.2.2、获得二个日期相差多少天

使用__sub__(...)和__rsub__(...)方法，其实二个方法差不太多，一个是正向操作，一个是反向操作：

示例

a = datetime.date(2017, 3, 22)
b = datetime.date(2017, 3, 15)
# 返回值datetime.timedelta(7)
a.__sub__(b)
# 返回值7
a.__sub__(b).days

# 返回值datetime.timedelta(-7)
a.__sub__(b)
# 返回值-7
a.__rsub__(b)
1
2
3
4
5
6
7
8
9
10
11

2.2.3、ISO 标准化日期

• isocalendar(...)：返回一个包含三个值的元组，三个值依次为：year年份，week number周数，weekday星期数（周一为1…周日为7)；

a = datetime.date(2017,3,22)
# 输出为：(2017, 12, 3)
a.isocalendar()
# 输出为：2017
a.isocalendar()[0]
# 输出为：12
a.isocalendar()[1]
# 输出为：3
a.isocalendar()[1]
1
2
3
4
5
6
7
8
9

• isoformat(...)：返回符合ISO 8601标准 (YYYY-MM-DD) 的日期字符串；

a = datetime.date(2017,3,22)
# 输出为：'2017-03-22'
a.isoformat()
1
2
3

• isoweekday(...)：返回符合ISO标准的指定日期所在的星期数（周一为1…周日为7)；

a = datetime.date(2017,3,22)
# 输出为：3
a.isoweekday()
1
2
3

• weekday(...)：weekday(...)方法返回的周一为 0, 周日为 6。

a = datetime.date(2017,3,22)
# 输出为：2
a.weekday()
1
2
3

2.2.4、其他方法与属性

• timetuple(...) ： 该方法为了兼容time.localtime(...)返回一个类型为time.struct_time的数组，但有关时间的部分元素值为0；

a = datetime.date(2017, 3, 22)
# time.struct_time(tm_year=2017, tm_mon=3, tm_mday=22, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=2, tm_yday=81, tm_isdst=-1)
a.timetuple()
# 输出为：2017
a.timetuple().tm_year
# 3
1
2
3
4
5
6

• toordinal(...)： 返回公元公历开始到现在的天数。公元1年1月1日为1；

a = datetime.date(2017,3,22)
# 输出为：736410
a.toordinal()
1
2
3

• replace(...)：返回一个替换指定日期字段的新date对象。参数3个可选参数，分别为year，month，day。注意替换是产生新对象，不影响原date对象；

a = datetime.date(2017,3,22)
b = a.replace(2017,2,28)
# 输出为：datetime.date(2017, 3, 22)
a
# 输出为：datetime.date(2017, 2, 28)
1
2
3
4
5

• resolution：date对象表示日期的最小单位。这里是天；

# 输出为：datetime.timedelta(1)
datetime.date.resolution
1
2

• fromordinal(...)：将Gregorian日历时间转换为date对象；Gregorian Calendar ：一种日历表示方法，类似于我国的农历，西方国家使用比较多；

a = datetime.date(2017,3,22)
b = a.toordinal()
# 输出为：datetime.date(2017, 3, 22)
datetime.date.fromordinal(b)
1
2
3
4

• fromtimestamp(...)：根据给定的时间戮，返回一个date对象；

# 输出为：1490165087.2242179
time.time()
# 输出为：datetime.date(2017, 3, 22)
datetime.date.fromtimestamp(time.time())
1
2
3
4

• today(...)：返回当前日期；

# 输出为：datetime.date(2017, 3, 22)
datetime.date.today()
1
2

• max： date类能表示的最大的年、月、日的数值；

# 输出为：datetime.date(9999, 12, 31)
datetime.date.max
1
2

• min： date类能表示的最小的年、月、日的数值。

# 输出为：datetime.date(1, 1, 1)
datetime.date.min
1
2

2.3、日期的字符串输出

2.3.1、如果你想将日期对象转化为字符串对象的话，可以用 __format__(...) 方法以指定格式进行日期输出

a = datetime.date(2017,3,22)
# 输出为：'2017-03-22'
a.__format__('%Y-%m-%d')
# 输出为：'2017/03/22'
a.__format__('%Y/%m/%d')
# 输出为：'17/03/22'
a.__format__('%y/%m/%d')
# 输出为：'03/22/17'
a.__format__('%D')
1
2
3
4
5
6
7
8
9

与此方法等价的方法为strftime(...)

# 输出为：'20170322'
a.strftime("%Y%m%d")
1
2

2.3.2、如果只是相简单的获得日期的字符串，则使用 __str__(...)

# 输出为：'2017-03-22'
a.__str__()
1
2

2.3.3、如果想要获得ctime样式的格式请使用 ctime(...)

# 输出为：'Wed Mar 22 00:00:00 2017'
a.ctime()
1
2

3、time类

3.1、time类的数据构成

time类由hour小时、minute分钟、second秒、microsecond毫秒和tzinfo五部分组成。

time([hour[, minute[, second[, microsecond[, tzinfo]]]]])
1

相应的，time类中就有上述五个变量来存储应该的值：

a = datetime.time(12,20,59,899)
# 输出为：datetime.time(12, 20, 59, 899)
a
# 输出为：12
a.hour
# 输出为：20
a.minute
# 输出为：59
a.second
# 输出来：899
a.microsecond
# 没有值
a.tzinfo
1
2
3
4
5
6
7
8
9
10
11
12
13

与date类一样，time类也包含__getattribute__(...)方法可以读取相关属性：

# 输出为：12
a.__getattribute__('hour')
# 输出为：20
a.__getattribute__('minute')
# 输出为：59
a.__getattribute__('second')
1
2
3
4
5
6

3.2、time类中的方法和属性

3.2.1、比较时间大小

相关方法包括：__eq__(...), __ge__(...), __gt__(...), __le__(...), __lt__(...)，__ne__(...)这里的方法与date类中定义的方法大同小异，使用方法与一样，这里就不过多介绍了，示例如下：

a = datetime.time(12,20,59,899)
b = datetime.time(11,20,59,889)
# 输出为：False
a.__eq__(b)
# 输出为：True
a.__ne__(b)
# 输出为：True
a.__ge__(b)
# 输出为：True
a.__gt__(b)
# 输出为：False
a.__le__(b)
# 输出为：False
a.__lt__(b)
1
2
3
4
5
6
7
8
9
10
11
12
13
14

3.2.2、__nonzero__(...)

判断时间对象是否非零，返回值为True/False：

a = datetime.time(12,20,59,899)
# 输出为：True
a.__nonzero__()
1
2
3

3.2.3、其他属性

• max：最大的时间表示数值

# 输出为：datetime.time(23, 59, 59, 999999)
datetime.time.max
1
2

• min：最小的时间表示数值

# 输出为：datetime.time(0, 0)
datetime.time.min
1
2

• resolution：时间间隔单位为分钟

# 输出为：datetime.timedelta(0, 0, 1)
datetime.time.resolution
1
2

3.3、时间的字符串输出

3.3.1、如果你想将时间对象转化为字符串对象的话，可以用**__format__(...)**方法以指定格式进行时间输出

a = datetime.time(12,20,59,899)
# 输出为：'12:20:59'
a.__format__('%H:%M:%S')
1
2
3

3.3.2、ISO 标准输出

a = datetime.time(12,20,59,899)
# 输出为：'12:20:59.000899'
a.isoformat()
1
2
3

与此方法等价的方法为strftime(...)

a = datetime.time(12,20,59,899)
# 输出为：'12:20:59'
a.strftime('%H:%M:%S')
1
2
3

3.3.3、如果只是相简单的获得时间的字符串，则使用 __str__(...)

a = datetime.time(12,20,59,899)
# 输出为：'12:20:59.000899'
a.__str__()
1
2
3

4、datetime类

4.1、datetime类的数据构成

datetime类其实是可以看做是date类和time类的合体，其大部分的方法和属性都继承于这二个类，相关的操作方法请参阅，本文上面关于二个类的介绍。其数据构成也是由这二个类所有的属性所组成的。

datetime(year, month, day[, hour[, minute[, second[, microsecond[,tzinfo]]]]])
1

4.2、datetime的方法和属性

4.2.1、date(…)：返回datetime对象的日期部分

a = datetime.datetime.now()
# 输出为：datetime.datetime(2017, 3, 22, 16, 9, 33, 494248)
a
# 输出为：datetime.date(2017, 3, 22)
a.date()
1
2
3
4
5

4.2.2、time(…)：返回datetime对象的时间部分

a = datetime.datetime.now()
# 输出为：datetime.datetime(2017, 3, 22, 16, 9, 33, 494248)
a
# 输出为：datetime.time(16, 9, 33, 494248)
a.time()
1
2
3
4
5

4.2.3、utctimetuple(…)：返回UTC时间元组

a = datetime.datetime.now()
# 输出为：datetime.datetime(2017, 3, 22, 16, 9, 33, 494248)
a
# 输出为：time.struct_time(tm_year=2017, tm_mon=3, tm_mday=22, tm_hour=16, tm_min=9, tm_sec=33, tm_wday=2, tm_yday=81, tm_isdst=0)
a.utctimetuple()
1
2
3
4
5

4.2.4、combine(…)：将一个date对象和一个time对象合并生成一个datetime对象

a = datetime.datetime.now()
# 输出为：datetime.datetime(2017, 3, 22, 16, 9, 33, 494248)
a
# 输出为：datetime.datetime(2017, 3, 22, 16, 9, 33, 494248)
datetime.datetime.combine(a.date(),a.time())
1
2
3
4
5

4.2.5、now(…)：返回当前日期时间的datetime对象

a = datetime.datetime.now()
# 输出为：datetime.datetime(2017, 3, 22, 16, 9, 33)
a
1
2
3

4.2.6、utcnow(…)：返回当前日期时间的UTC datetime对象

a = datetime.datetime.utcnow()
# 输出为：datetime.datetime(2017, 3, 22, 8, 26, 54, 935242)
a
1
2
3

4.2.7、strptime(…)：根据string，format 2个参数，返回一个对应的datetime对象

# 输出为：datetime.datetime(2017, 3, 22, 15, 25)
datetime.datetime.strptime('2017-3-22 15:25','%Y-%m-%d %H:%M')
1
2

4.2.8、utcfromtimestamp(…)：UTC时间戳的datetime对象，时间戳值为time.time()

# 输出为：datetime.datetime(2017, 3, 22, 8, 29, 7, 654272)
datetime.datetime.utcfromtimestamp(time.time())
1
2

5、timedelta 类

timedelta类是用来计算二个datetime对象的差值的。此类中包含如下属性：

• days：天数
• microseconds：微秒数(>=0 并且 <1秒）
• seconds：秒数(>=0 并且 <1天）

6、日期计算实操

6.1、获取当前日期时间

now = datetime.datetime.now()
# 输出为：datetime.datetime(2017, 3, 22, 16, 55, 49, 148233)
now

today = datetime.date.today()
# 输出为：datetime.date(2017, 3, 22)
today

# 输出为：datetime.date(2017, 3, 22)
now.date()

# 输出为：datetime.time(16, 55, 49, 148233)
now.time()
1
2
3
4
5
6
7
8
9
10
11
12
13

6.2、获取上个月第一天和最后一天的日期

today = datetime.date.today()
# 输出为：datetime.date(2017, 3, 22)
today

mlast_day = datetime.date(today.year, today.month, 1) - datetime.timedelta(1)
# 输出为：datetime.date(2017, 2, 28)
mlast_day

mfirst_day = datetime.date(mlast_day.year, mlast_day.month, 1)
# 输出为：datetime.date(2017, 2, 1)
mfirst_day
1
2
3
4
5
6
7
8
9
10
11

6.3、获取时间差

start_time = datetime.datetime.now()
end_time = datetime.datetime.now()
# 输出为：7
(end_time - start_time).seconds
1
2
3
4

6.4、计算当前时间向后8个小时的时间

d1 = datetime.datetime.now()
d2 = d1 + datetime.timedelta(hours = 8)
# 输出为：datetime.datetime(2017, 3, 23, 1, 10, 37, 182240)
d2
1
2
3
4

6.5、计算上周一和周日的日期

today = datetime.date.today()
# 输出为：datetime.date(2017, 3, 23)
today

today_weekday = today.isoweekday()
last_sunday = today - datetime.timedelta(days=today_weekday)
last_monday = last_sunday - datetime.timedelta(days=6)
# 输出为：datetime.date(2017, 3, 19)
last_sunday
# 输出为：datetime.date(2017, 3, 13)
last_monday
1
2
3
4
5
6
7
8
9
10
11

6.6、计算指定日期当月最后一天的日期和本月天数

date = datetime.date(2017,12,20)
def eomonth(date_object):
     if date_object.month == 12:
         next_month_first_date = datetime.date(date_object.year+1,1,1)
     else:
         next_month_first_date = datetime.date(date_object.year, date_object.month+1, 1)
     return next_month_first_date - datetime.timedelta(1)

# 输出为：datetime.date(2017, 12, 31)
eomonth(date)
# 输出为：31
eomonth(date).day
1
2
3
4
5
6
7
8
9
10
11
12

6.7、计算指定日期下个月当天的日期

date = datetime.date(2017,12,20)                                            
def edate(date_object):                                                     
     if date_object.month == 12:                          
         next_month_date = datetime.date(date_object.year+1, 1,date_object.day)
     else:
         next_month_first_day = datetime.date(date_object.year,date_object.month+1,1)
         if date_object.day > eomonth(last_month_first_day).day:
             next_month_date = datetime.date(date_object.year,date_object.month+1,eomonth(last_month_first_day).day)
         else:
             next_month_date = datetime.date(date_object.year, date_object.month+1, date_object.day)
     return next_month_date

# 输出为：datetime.date(2018, 1, 20)
edate(date)
1
2
3
4
5
6
7
8
9
10
11
12
13
14

6.8、获得本周一至今天的时间段并获得上周对应同一时间段

today = datetime.date.today()
this_monday = today - datetime.timedelta(today.isoweekday()-1)
last_monday = this_monday - datetime.timedelta(7)
last_weekday = today -datetime.timedelta(7)
# 输出为：datetime.date(2017, 3, 20)
this_monday

# 输出为：datetime.date(2017, 3, 23)
today

# 输出为：datetime.date(2017, 3, 13)
last_monday

# 输出为：datetime.date(2017, 3, 16)
last_weekday
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

7、python中时间日期格式化符号