6.4.datetime
Windows 10
Python 3.7.3 @ MSC v.1915 64 bit (AMD64)
# from tools import Help as H
import datetime
time：时间
time 实例只保存时间值，而不保存与时间相关的日期值。
t = datetime.time(hour=1, minute=2, second=3, microsecond=4, tzinfo=None)
print(t)
print('hour :', t.hour)
print('minute :', t.minute)
print('second :', t.second)
print('microsecond:', t.microsecond)
print('tzinfo :', t.tzinfo)
01:02:03.000004
hour : 1
minute : 2
second : 3
microsecond: 4
tzinfo : None
min 和 max 类的属性代表一天内的有效时间范围。time 的精度（即 time 能够有效表示的最小时间间隔）被限制为1微秒。
print("最小时间")
print('min:', datetime.time.min)
print("最大时间")
print('min:', datetime.time.max)
print("最小刻度单位")
print('Resolution:', datetime.time.resolution)
最小时间
min: 00:00:00
最大时间
min: 23:59:59.999999
最小刻度单位
Resolution: 0:00:00.000001
其他构造器：datetime.date.today()：
datetime.date.today()
datetime.date(2020, 2, 3)
date：日期
日历日期可以用 date 类来描述。date 类实例化后有属性 year， month，和 day。
# 如果参数超出限制范围，抛出ValueError异常
MYdate = datetime.date(year=2019,month=3,day=22)
print(MYdate)
print('year :', MYdate.year)
print('month :', MYdate.month)
print('day :', MYdate.day)
print("最小时间")
print('min:', datetime.date.min)
print("最大时间")
print('min:', datetime.date.max)
print("最小刻度单位")
print('Resolution:', datetime.date.resolution)
2019-03-22
year : 2019
month : 3
day : 22
最小时间
min: 0001-01-01
最大时间
min: 9999-12-31
最小刻度单位
Resolution: 1 day, 0:00:00
其他构造函数
import time
t = time.time()
从timestamp构造date
datetime.date.fromtimestamp(t)
datetime.date(2020, 2, 3)
从proleptic Gregorian ordinal构造date
datetime.date.fromordinal(737140)
datetime.date(2019, 3, 22)
从ISO格式的日期构造date
datetime.date.fromisoformat('2019-03-22')
datetime.date(2019, 3, 22)
date → 字符串时间
print(datetime.date.ctime(MYdate))
print(datetime.date.strftime(MYdate, "%a %b %d %H:%M:%S %Y"))
Fri Mar 22 00:00:00 2019
Fri Mar 22 00:00:00 2019
date → struct_time
datetime.date.timetuple(MYdate)
time.struct_time(tm_year=2019, tm_mon=3, tm_mday=22, tm_hour=0,
tm_min=0, tm_sec=0, tm_wday=4, tm_yday=81, tm_isdst=-1)
日期函数
Return a 3-tuple containing ISO year, week number, and weekday.
datetime.date.isocalendar(MYdate)
(2019, 12, 5)
Return the date formatted according to ISO.This is 'YYYY-MM-DD'.
datetime.date.isoformat(MYdate)
'2019-03-22'
"Return day of the week, where Monday == 1 ... Sunday == 7."
datetime.date.isoweekday(MYdate)
5
"Return day of the week, where Monday == 0 ... Sunday == 6."
datetime.date.weekday(MYdate)
4
Return proleptic Gregorian ordinal for the year, month and day.
datetime.date.toordinal(MYdate)
737140
datetime：日期和时间
date_time = datetime.datetime(year=2020, month=3,
day=23, hour=10,
minute=15, second=30,
microsecond=4, tzinfo=None)
其他构造函数
datetime.datetime.utcnow()
datetime.datetime.now()
datetime.datetime.today()
datetime.datetime.fromisoformat('2019-03-22-10:15:30')
datetime.datetime.fromordinal(737140)
datetime.datetime.fromtimestamp(time.time())
datetime.datetime.utcfromtimestamp(time.time())
datetime.datetime(2020, 2, 3, 13, 11, 31, 149891)
datetime → date
date_time = datetime.datetime.now()
datetime.datetime.date(date_time)
datetime.date(2020, 2, 3)
datetime → time
datetime.datetime.time(date_time)
datetime.time(21, 11, 31, 172888)
date and time → datetime
t1 = datetime.date.today()
t2 = datetime.time(hour=10, minute=15, second=30)
datetime.datetime.combine(t1, t2)
datetime.datetime(2020, 2, 3, 10, 15, 30)
datetime → time string
datetime.datetime.ctime(date_time)
print(datetime.datetime.strftime(date_time, "%a %b %d %H:%M:%S %Y"))
Mon Feb 03 21:11:31 2020
time string → datetime
datetime.datetime.strptime('Mon Feb 3 19:56:21 2020', "%a %b %d %H:%M:%S %Y")
datetime.datetime(2020, 2, 3, 19, 56, 21)
datetime → timestamp
datetime.datetime.timestamp(date_time)
1580735491.172888
datetime → timetuple
datetime.datetime.timetuple(date_time)
datetime.datetime.utctimetuple(date_time)
time.struct_time(tm_year=2020, tm_mon=2, tm_mday=3, tm_hour=21,
tm_min=11, tm_sec=31, tm_wday=0, tm_yday=34, tm_isdst=0)
其他函数
datetime.datetime.toordinal(date_time)
datetime.datetime.isocalendar(date_time)
datetime.datetime.isoformat(date_time)
datetime.datetime.isoweekday(date_time)
datetime.datetime.weekday(date_time)
datetime.datetime.astimezone(date_time, tz=None)
datetime.datetime.dst(date_time)
date_time.astimezone(tz=None)
datetime.datetime(2020, 2, 3, 21, 11, 31, 172888,
tzinfo=datetime.timezone(datetime.timedelta(seconds=28800),
'?D1¨²¡À¨º¡Á?¨º¡À??'))
['astimezone', 'dst', 'replace', 'timetz', 'tzname', 'utcoffset']
timedelta
可以使用两个 datetime 对象的基本运算来计算未来和过去的日期，或者是通过将一个 datetime 对象和一个 timedelta 对象相结合的方法来计算。不同的日期相减会产生一个 timedelta ，一个日期加上或者减去一个 timedelta 会产生另一个日期。 timedelta 的内部值以天、秒和微秒的形式存储。
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
可以使用 total_seconds() 将 timedelta 的整个持续时间检索为秒数。
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('{:15} = {:8} seconds'.format(
str(delta), delta.total_seconds())
)
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
日期算术运算
one_day = datetime.timedelta(days=1)
today = datetime.date.today()
yesterday = today - one_day
tomorrow = today + one_day
print(type(today))
type(yesterday) == type(today) == type(tomorrow)
<class 'datetime.date'>
True
timedelta 对象还支持与整型数、浮点数和其它 timedelta 实例的算术运算。
one_day = datetime.timedelta(days=1)
print('1 day :', one_day)
print('5 days :', one_day * 5)
print('1.5 days :', one_day * 1.5)
print('1/4 day :', one_day / 4)
# 假设午饭时间为 1 小时
work_day = datetime.timedelta(hours=7)
meeting_length = datetime.timedelta(hours=1)
print('meetings per day :', work_day / meeting_length)
1 day : 1 day, 0:00:00
5 days : 5 days, 0:00:00
1.5 days : 1 day, 12:00:00
1/4 day : 6:00:00
meetings per day : 7.0
比较数值
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: 2020-02-03
d2: 2020-02-04
d1 > d2: False
格式化和解析
datetime 对象默认的字符串表示法采用的是 ISO-8601 格式 (YYYY-MM-DDTHH:MM:SS.mmmmmm)。当然也可以使用 strftime() 函数生成其它的格式。
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))
ISO : 2020-02-03 21:11:31.684806
strftime: Mon Feb 03 21:11:31 2020
strptime: Mon Feb 03 21:11:31 2020
相同的格式化代码可以与 Python 的 string formatting mini-language 一起使用，方法是将它们放在格式字符串的字段规范中的 : 后面。
today = datetime.datetime.today()
print('ISO :', today)
print('format(): {:%a %b %d %H:%M:%S %Y}'.format(today))
ISO : 2020-02-03 21:11:31.729803
format(): Mon Feb 03 21:11:31 2020
每一个 datetime 格式代码均以 % 为前缀，并且后面的冒号被当作是要输出的字符。
| 符号 | 含义 | 例子 |
|---|---|---|
%a |
星期的简写 | 'Wed' |
%A |
星期的完整写法 | 'Wednesday' |
%w |
星期代号 -- 从 0 (周日) 到 6 (周六) | '3' |
%d |
月的第几日 (个位数时，十位补 0) | '13' |
%b |
月份的简写 | 'Jan' |
%B |
月份的完整写法 | 'January' |
%m |
月份 | '01' |
%y |
年份的缩写 | '16' |
%Y |
年份的完整写法 | '2016' |
%H |
小时（ 24 小时制） | '17' |
%I |
小时（ 12 小时制） | '05' |
%p |
AM/PM | 'PM' |
%M |
分钟 | '00' |
%S |
秒 | '00' |
%f |
微秒 | '000000' |
%z |
设置时区（适用于对时区敏感的类） | '-0500' |
%Z |
时区名 | 'EST' |
%j |
一年的第几天 | '013' |
%W |
一年的第几周 | '02' |
%c |
当地当前日期和时间 | 'Wed Jan 13 17:00:00 2016' |
%x |
当地当前日期 | '01/13/16' |
%X |
当地当前时间 | '17:00:00' |
%% |
一个 % |
'%' |
时区
在 datetime 中，时区由 tzinfo 的子类表示。由于 tzinfo 是一个抽象基类，因此应用程序需要定义一个子类。为了让这个类能用，应用程序还要为一些方法提供适当的实现。
在 timezone 类中， datetime 确实包含了一个略为简单的实现。它使用 UTC 的固定偏移量，并且不支持一年中不同日期的不同偏移量。比如，使用夏令时的地方或者 UTC 的偏移量会随时间变化的地方。
min6 = datetime.timezone(datetime.timedelta(hours=-6))
plus6 = datetime.timezone(datetime.timedelta(hours=6))
d = datetime.datetime.now(min6)
print(min6, ':', d)
print(datetime.timezone.utc, ':',
d.astimezone(datetime.timezone.utc))
print(plus6, ':', d.astimezone(plus6))
# 转换为当前系统时间
d_system = d.astimezone()
print(d_system.tzinfo, ' :', d_system)
UTC-06:00 : 2020-02-03 07:11:31.756794-06:00
UTC : 2020-02-03 13:11:31.756794+00:00
UTC+06:00 : 2020-02-03 19:11:31.756794+06:00
?D1¨²¡À¨º¡Á?¨º¡À?? : 2020-02-03 21:11:31.756794+08:00
要想将 datetime 值从一个时区转换到另一个时区，可以使用 astimezone() 函数。在上面的例子中，在 UTC 的两边分别显示了 6 小时的时区，并且还使用 datetime.timezone 中的 utc 实例作为参考。最后的输出行显示系统时区中的值，该值可以通过调用 astimezone() 函数获得，调用时不需要参数。