datatime汇总

datetime库概述

datetime库定义了2个常量和5个类。

2个常量分别是MINYEAR=1和MAXYEAR=9999。

5个类分别是：

1. date类：表示日期的类
2. time类：表示时间的类
3. datetime类：表示时间日期的类
4. timedelta类：表示两个datetime对象的差值；
5. tzinfo类：表示时区的相关信息

datetime的5个类详解

date类

date类包含三个参数，分别为year，month，day，返回格式为year-month-day。

构造函数

1. __new__(year,month,day)：默认的构造函数，创建date类的对象时直接传入year，month，day三个参数即可返回对应的日期。
2. fromtimestamp(t)：使用时间戳构造对象，使用方法为：datetime.date.fromtimestamp(t)，传入参数t为一个时间戳，返回时间戳t对应的日期。
3. today()：使用今天的日期构造对象，使用方法为：datetime.date.today()，无参数，返回今天的日期。
4. fromordinal(n)：使用日期序数构造对象，使用方法为：datetime.date.fromordinal(n)，传入参数为一个整数序数，代表从公元1年1月1日开始的序数，序数每增加1代表增加1天，返回最终计算出的日期。

方法

1. timetuple()：返回日期对应的time.struct_time对象，格式为time.struct_time(tm_year=1, tm_mon=1, tm_mday=2, tm_hour=0, tm_min=0, tm_sec=0, tm_wday=1, tm_yday=2, tm_isdst=-1) 。
2. toordinal()：相当于fromordinal(n)的逆过程，返回值即为fromordinal(n)中的日期序数n。
3. weekday()：返回该日期对应星期几，用[0,6]代表星期一到星期日。
4. isoweekday()：作用同weekday()，用[1,7]代表星期一到星期日。
5. isocalendar()：返回一个三元组，格式为(year,week_number,weekday)，分别代表年，第几周，星期几。
6. isoformat()：返回标准日期格式：YYYY-MM-DD。
7. ctime()：返回格式为：Sat Sep 8 00:00:00 2018
8. strftime(format)：把日期按照format指定的格式进行格式化，具体的格式化符号如下。
9. replace(year,month,day)：传入参数为year，month，day，返回对应的新日期。

%y 两位数的年份表示（00-99）
%Y 四位数的年份表示（000-9999）
%m 月份（01-12）
%d 月内中的一天（0-31）
%H 24小时制小时数（0-23）
%I 12小时制小时数（01-12）
%M 分钟数（00=59）
%S 秒（00-59）
%a 本地简化星期名称
%A 本地完整星期名称
%b 本地简化的月份名称
%B 本地完整的月份名称
%c 本地相应的日期表示和时间表示
%j 年内的一天（001-366）
%p 本地A.M.或P.M.的等价符
%U 一年中的星期数（00-53）星期天为星期的开始
%w 星期（0-6），星期天为星期的开始
%W 一年中的星期数（00-53）星期一为星期的开始
%x 本地相应的日期表示
%X 本地相应的时间表示
%Z 当前时区的名称
%% %号本身

time类

time类包含六个参数，分别为hour，minute，second，microsecond，tzinfo，fold，返回格式为hour:minute:second(.microsecond)。

构造函数

__new__(hour=0, minute=0, second=0, microsecond=0, tzinfo=None, fold=0)：默认的构造函数，创建time类的对象时直接传入相应参数即可返回对应的时间。

方法

1. isoformat()：返回标准时间格式：HH:MM:SS.mmmmmm+zz:zz。
2. strftime(format)：把时间按照format指定的格式进行格式化，具体的格式化符号与date类中介绍的相同。
3. utcoffset()：返回timezone的偏移量。
4. tzname()：返回timezone的名称。
5. replace()：传入对应的参数，返回新的时间。

datetime类

datetime类是date类和time类的合体，包含前两个类的全部参数。

构造函数

1. __new__(year, month, day, hour=0, minute=0, second=0,microsecond=0, tzinfo=None, fold=0)：默认的构造函数，创建datetime类的对象时直接传入相应参数即可返回对应的时间日期。
2. fromtimestamp(t)：使用时间戳构造对象，传入参数t为一个时间戳，返回时间戳t对应的日期和时间。
3. utcfromtimestamp(t)：使用时间戳构造对象，传入参数t为一个时间戳，返回时间戳t对应的UTC（时间标准时间）日期和时间。
4. now()：使用当前日期和时间构造对象，无参数，返回当前的日期和时间。
5. utcnow()：使用当前日期和时间构造对象，无参数，返回当前的UTC（时间标准时间）日期和时间。
6. combine(date,time)：使用date和time构造对象，传入参数为1个date对象和1个time对象，返回计算出的日期。

方法

1. timetuple()：返回日期时间对应的time.struct_time对象，格式为time.struct_time(tm_year=1973, tm_mon=11, tm_mday=29, tm_hour=21, tm_min=33, tm_sec=9, tm_wday=3, tm_yday=333, tm_isdst=-1) 。
2. utctimetuple()：与timetuple()相似，返回日期时间对应的UTC（时间标准时间）time.struct_time对象。
3. astimezone()：返回的格式中加入时区信息，格式为：1973-11-29 21:33:09+08:00。
4. date()：返回date部分
5. time()：返回time部分，tzinfo设置为None。（另有timetz()方法返回有相同tzinfo的time()）
6. isoformat(sep)：返回标准日期时间格式，传入参数sep可设置日期和时间的分隔符，默认为'T'：1973-11-29T21:33:09。
7. ctime()：返回格式为：Sat Sep 8 00:00:00 2018
8. strftime(format)：把日期按照format指定的格式进行格式化，具体的格式化符号与date类中介绍的相同。
9. strptime(date_string,format)：将字符串格式转换为日期格式，具体的格式化符号与date类中介绍的相同。
10. replace()：传入对应的参数，返回新的日期时间。

timedelta类

timedelta类代表两个datetime对象之间的时间差。

构造函数

__new__(days=0, seconds=0, microseconds=0,milliseconds=0, minutes=0, hours=0, weeks=0)：默认的构造函数，创建timedelta类的对象时直接传入相应参数即可返回对应单位的时间差。

方法

1. 支持两个timedelta对象之间的加、减操作。
2. 支持对一个timedelta进行取正、取负、取绝对值等操作。
3. 支持两个timedelta对象之间的比较。
4. 支持一个timedelta对象乘以、除以一个整数的操作

tzinfo类

tzinfo类是一个虚拟基类，代表时区（time zone），创建子类时必须重写name()，utcoffset()，dst()这三个方法。

常用方法汇总

utc > local_time

import datetime
import pytz

str_time = "2019-08-22T0:0:00Z"


def utc_to_local(country_code, utc_time_str):
    utc_time_str = utc_time_str[:-1] + "+00:00"
    local_tz = pytz.timezone(pytz.country_timezones(country_code)[0])
    local_format = "%Y-%m-%d %H:%M:%S"
    utc_dt = datetime.datetime.strptime(utc_time_str, '%Y-%m-%dT%H:%M:%S+00:00')
    local_dt = utc_dt.replace(tzinfo=pytz.utc).astimezone(local_tz)
    time_str = datetime.datetime.strptime(local_dt.strftime(local_format), local_format)
    return time_str


s = utc_to_local('cn', str_time)
print(s, type(s))
# 2019-08-22 08:00:00 <class 'datetime.datetime'>

 时间差秒

import datetime, time

start_time = datetime.datetime.now()
time.sleep(2.1)
end_time = datetime.datetime.now()
print((end_time - start_time).total_seconds())